Author: mimir Date: 2005-07-27 21:59:16 +0000 (Wed, 27 Jul 2005) New Revision: 8808
WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba&rev=8808 Log: More comments. rafal Modified: branches/SAMBA_4_0/source/libnet/userman.c Changeset: Modified: branches/SAMBA_4_0/source/libnet/userman.c =================================================================== --- branches/SAMBA_4_0/source/libnet/userman.c 2005-07-27 21:46:06 UTC (rev 8807) +++ branches/SAMBA_4_0/source/libnet/userman.c 2005-07-27 21:59:16 UTC (rev 8808) @@ -465,6 +465,9 @@ }; +/** + * Step 1: Lookup user name + */ static NTSTATUS usermod_lookup(struct composite_context *c, struct usermod_state *s) { @@ -497,6 +500,9 @@ } +/** + * Stage 2: Open user account + */ static NTSTATUS usermod_open(struct composite_context *c, struct usermod_state *s) { @@ -577,6 +583,9 @@ } +/** + * Stage 3: Set new user account data + */ static NTSTATUS usermod_modify(struct composite_context *c, struct usermod_state *s) { @@ -589,6 +598,13 @@ } +/** + * Event handler for asynchronous request. Handles transition through + * intermediate stages of the call. + * + * @param req rpc call context + */ + static void usermod_handler(struct rpc_request *req) { struct composite_context *c = req->async.private; @@ -622,6 +638,13 @@ } +/** + * Sends asynchronous usermod request + * + * @param p dce/rpc call pipe + * @param io arguments and results of the call + */ + struct composite_context *libnet_rpc_usermod_send(struct dcerpc_pipe *p, struct libnet_rpc_usermod *io) { @@ -661,6 +684,15 @@ } +/** + * Waits for and receives results of asynchronous usermod call + * + * @param c composite context returned by asynchronous usermod call + * @param mem_ctx memory context of the call + * @param io pointer to results (and arguments) of the call + * @return nt status code of execution + */ + NTSTATUS libnet_rpc_usermod_recv(struct composite_context *c, TALLOC_CTX *mem_ctx, struct libnet_rpc_usermod *io) { @@ -674,6 +706,15 @@ } +/** + * Synchronous version of usermod call + * + * @param pipe dce/rpc call pipe + * @param mem_ctx memory context for the call + * @param io arguments and results of the call + * @return nt status code of execution + */ + NTSTATUS libnet_rpc_usermod(struct dcerpc_pipe *pipe, TALLOC_CTX *mem_ctx, struct libnet_rpc_usermod *io)