summaryrefslogtreecommitdiff
path: root/source4
diff options
context:
space:
mode:
authorRafal Szczesniak <mimir@samba.org>2005-06-14 22:08:00 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 13:18:11 -0500
commit5f7f9eb11b0615204fb386c5744e9c505c0bc139 (patch)
tree6e21fcbdeb1f8a7058f497011d1364fa035f4eaf /source4
parentc2747479e04761d86f0de4aa90b4d793856d0fb7 (diff)
downloadsamba-5f7f9eb11b0615204fb386c5744e9c505c0bc139.tar.gz
samba-5f7f9eb11b0615204fb386c5744e9c505c0bc139.tar.bz2
samba-5f7f9eb11b0615204fb386c5744e9c505c0bc139.zip
r7587: More comments.
rafal (This used to be commit 265b1ab0cc2597d277630c56553a1c6243f6994b)
Diffstat (limited to 'source4')
-rw-r--r--source4/libnet/domain.c41
1 files changed, 41 insertions, 0 deletions
diff --git a/source4/libnet/domain.c b/source4/libnet/domain.c
index eec2a31e3d..eb7a4341ec 100644
--- a/source4/libnet/domain.c
+++ b/source4/libnet/domain.c
@@ -47,6 +47,9 @@ struct domain_open_state {
};
+/**
+ * Stage 1: Connect to SAM server.
+ */
static NTSTATUS domain_open_connect(struct composite_context *c,
struct domain_open_state *s)
{
@@ -74,14 +77,19 @@ failure:
}
+/**
+ * Stage 2: Lookup domain by name.
+ */
static NTSTATUS domain_open_lookup(struct composite_context *c,
struct domain_open_state *s)
{
struct samr_OpenDomain *r = &s->open;
+ /* receive samr_LookupDomain reply */
c->status = dcerpc_ndr_request_recv(s->req);
NT_STATUS_NOT_OK_RETURN(c->status);
+ /* prepare for samr_OpenDomain call */
r->in.connect_handle = &s->connect_handle;
r->in.access_mask = SEC_FLAG_MAXIMUM_ALLOWED;
r->in.sid = s->lookup.out.sid;
@@ -101,9 +109,13 @@ failure:
}
+/*
+ * Stage 3: Open domain.
+ */
static NTSTATUS domain_open_open(struct composite_context *c,
struct domain_open_state *s)
{
+ /* receive samr_OpenDomain reply */
c->status = dcerpc_ndr_request_recv(s->req);
NT_STATUS_NOT_OK_RETURN(c->status);
@@ -113,6 +125,12 @@ static NTSTATUS domain_open_open(struct composite_context *c,
}
+/**
+ * Event handler for asynchronous request. Handles transition through
+ * intermediate stages of the call.
+ *
+ * @param req rpc call context
+ */
static void domain_open_handler(struct rpc_request *req)
{
struct composite_context *c = req->async.private;
@@ -142,6 +160,12 @@ static void domain_open_handler(struct rpc_request *req)
}
+/**
+ * Sends asynchronous domain_open request
+ *
+ * @param p dce/rpc call pipe
+ * @param io arguments and results of the call
+ */
struct composite_context *libnet_rpc_domain_open_send(struct dcerpc_pipe *p,
struct libnet_rpc_domain_open *io,
void (*monitor)(struct monitor_msg*))
@@ -185,12 +209,21 @@ failure:
}
+/**
+ * Waits for and receives result of asynchronous domain_open call
+ *
+ * @param c composite context returned by asynchronous domain_open 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_domain_open_recv(struct composite_context *c, TALLOC_CTX *mem_ctx,
struct libnet_rpc_domain_open *io)
{
NTSTATUS status;
struct domain_open_state *s;
+ /* wait for results of sending request */
status = composite_wait(c);
if (NT_STATUS_IS_OK(status) && io) {
@@ -203,6 +236,14 @@ NTSTATUS libnet_rpc_domain_open_recv(struct composite_context *c, TALLOC_CTX *me
}
+/**
+ * Synchronous version of domain_open 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_domain_open(struct dcerpc_pipe *p,
TALLOC_CTX *mem_ctx,
struct libnet_rpc_domain_open *io)