summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2004-04-09 17:09:00 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 12:51:10 -0500
commit6dd74453981da79b573ff8d06ec0261f32863aad (patch)
tree01736ba739eacd5914669808f620a3f4ff62dfaa
parentab53890d59c8d25cefd333c0b15046f8a7ac5f8f (diff)
downloadsamba-6dd74453981da79b573ff8d06ec0261f32863aad.tar.gz
samba-6dd74453981da79b573ff8d06ec0261f32863aad.tar.bz2
samba-6dd74453981da79b573ff8d06ec0261f32863aad.zip
r137: Add notes about handles in dcesrv pipes
(This used to be commit 9bd7e9438e88545abe3a555624be4717db47e0c0)
-rw-r--r--prog_guide.txt13
1 files changed, 13 insertions, 0 deletions
diff --git a/prog_guide.txt b/prog_guide.txt
index f2d78ae0b2..e972d4482e 100644
--- 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