共用方式為

RpcBindingFromStringBindingW 函式 （rpcdce.h）

  • 發行項

RpcBindingFromStringBinding 函式會從系結句柄的字串表示傳回系結句柄。

語法

RPC_STATUS RpcBindingFromStringBindingW(
  RPC_WSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

參數

StringBinding

系結句柄的字串表示指標。

Binding

傳回伺服器系結句柄的指標。

傳回值

價值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_STRING_BINDING
 字串系結無效。
RPC_S_PROTSEQ_NOT_SUPPORTED
 此主機上不支援通訊協議順序。
RPC_S_INVALID_RPC_PROTSEQ
 通訊協議順序無效。
RPC_S_INVALID_ENDPOINT_FORMAT
 端點格式無效。
RPC_S_STRING_TOO_LONG
 字串太長。
RPC_S_INVALID_NET_ADDR
 網路地址無效。
RPC_S_INVALID_ARG
 自變數無效。
RPC_S_INVALID_NAF_ID
 網路位址系列標識碼無效。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

RpcBindingFromStringBinding 函式會從系結句柄的字串表示法建立伺服器系結句柄。 StringBinding 參數不需要包含物件 UUID。 在此情況下，傳回的系結包含 nil UUID。 如果提供的 StringBinding 參數不包含端點欄位，則傳回 Binding 參數是部分系結的系結句柄。 如果提供的 StringBinding 參數包含端點欄位，則端點會被視為已知的端點。 如果提供的 StringBinding 參數不包含主機位址欄位，則傳回 Binding 參數會參考本機主機。

應用程式會藉由呼叫 rpcStringBindingCompose 函式或提供字元字串常數，來建立字串系結。 這個方法建立字串系結並不涉及與伺服器連絡。 API 的成功或失敗不會指出伺服器可用性。

當應用程式使用 Binding 參數完成時，應用程式應該呼叫 RpcBindingFree 函式來釋放系結句柄所使用的記憶體。

注意

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

要求

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

另請參閱

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose