次の方法で共有

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

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

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

Protseq

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

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

NetworkAddr

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

Endpoint

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

NetworkOptions

ネットワーク オプションの null で終わる文字列表現へのポインターへのポインターを返します。

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー rpcdce.h (Rpc.h を含む)
Library Rpcrt4.lib
[DLL] Rpcrt4.dll

こちらもご覧ください

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree