rpcStringBindingCompose 函式 (rpcdce.h)

  • 發行項

RpcStringBindingCompose 函式會建立字串系結句柄。

語法

RPC_STATUS RpcStringBindingCompose(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

參數

ObjUuid

物件 UUID之 Null 終止字串表示的指標。 例如，字串 6B29FC40-CA47-1067-B31D-00DD010662DA 代表有效的 UUID。

ProtSeq

通訊協定序列之 Null 終止字串表示的指標。 請參閱附註。

NetworkAddr

網路位址之 Null 終止字串表示的指標。 網路位址格式與通訊協定順序相關聯。 請參閱附註。

Endpoint

端點之 Null 終止字串表示的指標。 端點格式和內容會與通訊協定順序相關聯。 例如，與通訊協定序列相關聯的端點 ncacn_np 是格式為 \pipe\pipename 的管道名稱。 請參閱附註。

Options

以 Null 終止之網路選項字串表示的指標。 選項字串與通訊協定序列相關聯。 請參閱附註。

StringBinding

傳回系結句柄 之 Null 終止字串表示的指標指標。

指定 NULL 值以防止 RpcStringBindingCompose 傳回 StringBinding 參數。 在此情況下，應用程式不會呼叫 RpcStringFree。 請參閱附註。

注意 如需詳細資訊，請參閱 字串系結。
 

傳回值

值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_STRING_UUID
 UUID 的字串表示無效。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

應用程式會呼叫 RpcStringBindingCompose 例程，將物件 UUID、通訊協定序列、網路位址、端點和其他網路選項結合成系結句柄的字串表示。

RPC 執行時間連結庫會為 StringBinding 參數中傳回的字串配置記憶體。 應用程式負責呼叫 RpcStringFree 以解除分配該記憶體。

指定 null 參數值，或針對沒有數據的每個輸入字串提供空字串 (\0) 。

C 語言字串內的常值反斜杠字元必須加上引號。 ncacn_np通訊協定序列之伺服器名稱的實際 C 字串會顯示為 \\servername，而管道名稱的實際 C 字串會顯示為 \pipe\pipename。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 rpcdce.h (包含 Rpc.h)
程式庫 Rpcrt4.lib
Dll Rpcrt4.dll

另請參閱

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree