共用方式為

RpcStringBindingParseW 函式 （rpcdce.h）

  • 發行項

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

語法

RPC_STATUS RpcStringBindingParseW(
  RPC_WSTR StringBinding,
  RPC_WSTR *ObjUuid,
  RPC_WSTR *Protseq,
  RPC_WSTR *NetworkAddr,
  RPC_WSTR *Endpoint,
  RPC_WSTR *NetworkOptions
);

參數

StringBinding

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

ObjUuid

傳回 null結束之物件之字串表示的指標，UUID。

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

Protseq

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

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

NetworkAddr

傳回指向 null-terminated 字串表示之網路位址的指標。 指定 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 例程 RpcStringBindingParse，將系結句柄的字串表示剖析成其元件欄位。

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

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

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

注意

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

要求

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

另請參閱

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree