次の方法で共有

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

バインドの -terminated 文字列表現null へのポインター。

ObjUuid

UUIDオブジェクトの null終了文字列表現へのポインターを返します。

RpcStringBindingParse が ObjectUuid パラメーターを返さないように、NULL 値を指定します。 この場合、アプリケーションは RpcStringFree呼び出しません。

Protseq

プロトコル シーケンスの終端文字列表現null へのポインターへのポインターを返します。 Microsoft RPC でサポートされているプロトコル シーケンスの一覧については、「文字列バインディング」を参照してください。

RpcStringBindingParse が ProtSeq パラメーターを返さないようにするには、NULL 値を指定します。 この場合、アプリケーションは RpcStringFree呼び出しません。

NetworkAddr

ネットワーク アドレスの終端文字列表現null へのポインターへのポインターを返します。 RpcStringBindingParse が NetworkAddr パラメーターを返さないようにするには、NULL 値を指定します。 この場合、アプリケーションは RpcStringFree呼び出しません。

Endpoint

エンドポイントの終端文字列表現、null へのポインターへのポインターを返します。 NULL 値を指定して、RpcStringBindingParse が EndPoint パラメーターを返さないようにします。 この場合、アプリケーションは RpcStringFree呼び出しません。

NetworkOptions

null-terminated 文字列形式のネットワーク オプションへのポインターを返します。

RpcStringBindingParse が NetworkOptions パラメーター 返されないようにするには、NULL 値を指定します。 この場合、アプリケーションは RpcStringFree呼び出しません。

戻り値

価値 意味
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INVALID_STRING_BINDING
 文字列バインディングが無効です。
 
注 有効なエラー コードの一覧については、「RPC 戻り値」を参照してください。
 

備考

アプリケーション RpcStringBindingParse ルーチンを呼び出して、バインド ハンドルの文字列形式をそのコンポーネント フィールドに解析します。

RPC ランタイム ライブラリは、返される各コンポーネント文字列にメモリを割り当てます。 アプリケーションは、返された文字列ごとに rpcStringFree を 1 回呼び出して、その文字列のメモリの割り当てを解除する役割を担います。

StringBinding パラメーターのいずれかのフィールドが空の場合、RpcStringBindingParse は、対応する出力パラメーターに空の文字列 (\0) を返します。

注 クライアントのアドレスを照会するには、アプリケーションは RpcBindingServerFromClient 関数を呼び出して部分的にバインドされたサーバー バインド ハンドルを取得することから始めます。 サーバー バインド ハンドルを使用して、RpcBindingToStringBinding を呼び出すことによって文字列バインディングを取得できます。 その後、サーバーは RpcStringBindingParse を呼び出して、文字列バインディングからクライアントのネットワーク アドレスを抽出できます。
 

手記

rpcdce.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RpcStringBindingParse を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー rpcdce.h (Rpc.h を含む)
ライブラリ Rpcrt4.lib
DLL Rpcrt4.dll

関連項目

RpcBindingFromStringBinding

RpcBindingToStringBinding の

RpcStringBindingCompose の

RpcStringFree を する