r956: More debian updates:

[samba.git] / prog_guide.txt

diff --git a/prog_guide.txt b/prog_guide.txt
index f2d78ae0b2b59aac998a5fb176ad78f042eb27e2..3523edb4e7c82e03036301e3a8a74a571ad6c40f 100644 (file)
--- a/prog_guide.txt
+++ b/prog_guide.txt
@@ -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
@@ -744,6 +757,3 @@ docs
 svn instructions
 
 test commit
-
-
-