rpcStringBindingParse 函式 (rpcdce.h)

  • 發行項

RpcStringBindingParse 函式會以個別字串傳回物件 UUID 部分和字串系結的位址部分。 應用程式會呼叫 RpcStringBindingParse ，將系結句柄的字串表示剖析為其元件欄位。 RpcStringBindingParse 函式會以個別字串傳回物件 UUID 部分和字串系結的位址部分。

語法

RPC_STATUS RpcStringBindingParse(
  RPC_CSTR StringBinding,
  RPC_CSTR *ObjUuid,
  RPC_CSTR *Protseq,
  RPC_CSTR *NetworkAddr,
  RPC_CSTR *Endpoint,
  RPC_CSTR *NetworkOptions
);

參數

StringBinding

系結之 Null 終止字串表示的指標。

ObjUuid

傳回指標指向物件 UUID之 Null 終止字串表示的指標。

指定 NULL 值以防止 RpcStringBindingParse 傳回 ObjectUuid 參數。 在此情況下，應用程式不會呼叫 RpcStringFree。

Protseq

傳回指標指向通訊協定序列 之 Null 終止字串表示的指標。 如需 Microsoft RPC 支援的通訊協定序列清單，請參閱 字串系結。

指定 NULL 值以防止 RpcStringBindingParse 傳回 ProtSeq 參數。 在此情況下，應用程式不會呼叫 RpcStringFree。

NetworkAddr

傳回以 Null 終止之網路位址之字串表示的指標指標。 指定 NULL 值以防止 RpcStringBindingParse 傳回 NetworkAddr 參數。 在此情況下，應用程式不會呼叫 RpcStringFree。

Endpoint

傳回端點 之 Null 終止字串表示的指標指標。 指定 NULL 值以防止 RpcStringBindingParse 傳回 EndPoint 參數。 在此情況下，應用程式不會呼叫 RpcStringFree。

NetworkOptions

傳回 以 Null 終止之網路選項字串表示的指標指標。

指定 NULL 值以防止 RpcStringBindingParse 傳回 NetworkOptions 參數。 在此情況下，應用程式不會呼叫 RpcStringFree。

傳回值

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

備註

應用程式會呼叫 RpcStringBindingParse 例程，將系結句柄的字串表示剖析為其元件欄位。

RPC 執行時間連結庫會為每個傳回的元件字串配置記憶體。 應用程式負責呼叫 RpcStringFree 一次，讓每個傳回的字串解除分配該字串串的記憶體。

如果 StringBinding 參數的任何字段是空的， RpcStringBindingParse 會在對應的輸出參數中傳回空字串 (\0) 。

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

規格需求

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

另請參閱

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree