共用方式為

RpcStringBindingComposeW 函式 （rpcdce.h）

  • 發行項

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

語法

RPC_STATUS RpcStringBindingComposeW(
  RPC_WSTR ObjUuid,
  RPC_WSTR ProtSeq,
  RPC_WSTR NetworkAddr,
  RPC_WSTR Endpoint,
  RPC_WSTR Options,
  RPC_WSTR *StringBinding
);

參數

ObjUuid

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

ProtSeq

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

NetworkAddr

null 的指標-terminated 字串表示網路位址。 網路位址格式與通訊協定順序相關聯。 請參閱附注。

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。

注意

rpcdce.h 標頭會根據 UNICODE 預處理器常數的定義，將 RpcStringBindingCompose 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平臺 窗戶
標頭 rpcdce.h （包括 Rpc.h）
連結庫 Rpcrt4.lib
DLL Rpcrt4.dll

另請參閱

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree