s3-rpc_server: Fixed rpc_pipe_open_internal documentation.

Signed-off-by: Günther Deschner <gd@samba.org>

1 files changed, 11 insertions, 5 deletions

diff --git a/source3/rpc_server/rpc_ncacn_np.c b/source3/rpc_server/rpc_ncacn_np.c
index e592805957..df9799b1e6 100644
--- a/source3/rpc_server/rpc_ncacn_np.c
+++ b/source3/rpc_server/rpc_ncacn_np.c
@@ -510,18 +510,24 @@ NTSTATUS rpcint_binding_handle(TALLOC_CTX *mem_ctx,
 }
 
 /**
- * @brief Create a new RPC client context which uses a local dispatch function.
+ * @internal
+ *
+ * @brief Create a new RPC client context which uses a local transport.
+ *
+ * This creates a local transport. It is a shortcut to directly call the server
+ * functions and avoid marschalling.
  *
  * @param[in]  mem_ctx  The memory context to use.
  *
  * @param[in]  abstract_syntax Normally the syntax_id of the autogenerated
  *                             ndr_table_<name>.
  *
- * @param[in]  dispatch The corresponding autogenerated dispatch function
- *                      rpc_<name>_dispatch.
- *
  * @param[in]  serversupplied_info The server supplied authentication function.
  *
+ * @param[in]  client_id The client address information.
+ *
+ * @param[in]  msg_ctx  The messaging context to use.
+ *
  * @param[out] presult  A pointer to store the connected rpc client pipe.
  *
  * @return              NT_STATUS_OK on success, a corresponding NT status if an
@@ -533,8 +539,8 @@ NTSTATUS rpcint_binding_handle(TALLOC_CTX *mem_ctx,
  *
  *   status = rpc_pipe_open_internal(tmp_ctx,
  *                                   &ndr_table_winreg.syntax_id,
- *                                   rpc_winreg_dispatch,
  *                                   p->session_info,
+ *                                   client_id,
  *                                   &winreg_pipe);
  * @endcode
  */