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 を呼び出しません。

戻り値

注釈

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

RPC ランタイム ライブラリは、返されるコンポーネント文字列ごとにメモリを割り当てます。 返された文字列ごとに RpcStringFree を 1 回呼び出して、その文字列のメモリの割り当てを解除する必要があります。

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

要件

こちらもご覧ください

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree