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 で終わる文字列表現へのポインターへのポインターを返します。

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 を呼び出して、文字列バインディングからクライアントのネットワーク アドレスを抽出できます。
 

要件

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

こちらもご覧ください

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree