r137: Add notes about handles in dcesrv pipes

diff --git a/prog_guide.txt b/prog_guide.txt
index f2d78ae0b2b59aac998a5fb176ad78f042eb27e2..e972d4482e70e6a6b45b572d9dc6f0538deb5286 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