r137: Add notes about handles in dcesrv pipes
authorJelmer Vernooij <jelmer@samba.org>
Fri, 9 Apr 2004 17:09:00 +0000 (17:09 +0000)
committerGerald (Jerry) Carter <jerry@samba.org>
Wed, 10 Oct 2007 17:51:10 +0000 (12:51 -0500)
(This used to be commit 9bd7e9438e88545abe3a555624be4717db47e0c0)

prog_guide.txt

index f2d78ae0b2b59aac998a5fb176ad78f042eb27e2..e972d4482e70e6a6b45b572d9dc6f0538deb5286 100644 (file)
@@ -600,7 +600,20 @@ IDEA: Maybe extend UNC names like this?
  smbclient //server/share
  smbclient //server/share:[sign,seal,spnego]
 
+DCERPC Handles
+--------------
+The various handles that are used in the RPC servers should be created and 
+fetch using the dcesrv_handle_* functions.
+
+Use dcesrv_handle_new(struct dcesrv_connection *, uint8 handle_type) to obtain 
+a new handle of the specified type. Handle types are unique within each 
+pipe.
+
+The handle can later be fetched again using
+struct dcesrv_handle *dcesrv_handle_fetch(struct dcesrv_connection *dce_conn, struct policy_handle *p, uint8 handle_type)
+and destroyed by dcesrv_handle_destroy(struct dcesrv_handle *).
 
+User data should be stored in the 'data' member of the dcesrv_handle struct.
 
 
 MSRPC