共用方式為

RpcBindingToStringBindingW 函式 （rpcdce.h）

  • 發行項

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

語法

RPC_STATUS RpcBindingToStringBindingW(
  RPC_BINDING_HANDLE Binding,
  RPC_WSTR           *StringBinding
);

參數

Binding

要轉換成系結句柄之字串表示的用戶端或伺服器系結句柄。

StringBinding

傳回 Binding 參數中所指定之系結句柄之字串表示的指標。

指定 null 值以防止 RpcBindingToStringBinding 傳回 StringBinding 參數。 在此情況下，應用程式不會呼叫 RpcStringFree 函式。

傳回值

價值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_BINDING
 系結句柄無效。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

RpcBindingToStringBinding 函式會將用戶端或伺服器系結句柄轉換成其字串表示法。

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

如果 Binding 參數中的系結句柄包含 nil 物件 UUID，則傳回的字串中不包含物件 UUID 字段。

若要剖析傳回 StringBinding 參數，請呼叫 rpcStringBindingParse 函式 。

注意 若要查詢用戶端的位址，應用程式會從呼叫 RpcBindingServerFromClient 函式開始，以取得部分系結的伺服器系結句柄。 伺服器系結句柄可用來叫用 RpcBindingToStringBinding 來取得字串系結。 然後，伺服器可以呼叫 RpcStringBindingParse，從字串系結擷取客戶端的網路位址。
 

注意

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

要求

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

另請參閱

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree