RpcBindingFromStringBinding 函式 (rpcdce.h)

  • 發行項

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

語法

RPC_STATUS RpcBindingFromStringBinding(
  RPC_CSTR           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 函式來釋放系結句柄所使用的記憶體。

規格需求

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

另請參閱

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose