rpcBindingToStringBinding 函式 (rpcdce.h)

  • 發行項

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

語法

RPC_STATUS RpcBindingToStringBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *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，從字串系結擷取客戶端的網路位址。
 

規格需求

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

另請參閱

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree