RpcStringBindingCompose 関数 (rpcdce.h)

RpcStringBindingCompose 関数は、文字列バインディング ハンドルを作成します。

構文

RPC_STATUS RpcStringBindingCompose(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

パラメーター

ObjUuid

オブジェクト UUIDnull で終わる文字列表現へのポインター。 たとえば、文字列 6B29FC40-CA47-1067-B31D-00DD010662DA は有効な UUID を表します。

ProtSeq

プロトコル シーケンスの null で終わる文字列表現へのポインター。 注を参照。

NetworkAddr

ネットワーク アドレスの null で終わる文字列表現へのポインター。 ネットワーク アドレス形式はプロトコル シーケンスに関連付けられています。 注を参照。

Endpoint

エンドポイントの null で終わる文字列表現へのポインター。 エンドポイントの形式とコンテンツは、プロトコル シーケンスに関連付けられます。 たとえば、プロトコル シーケンス ncacn_np に関連付けられているエンドポイントは、\pipe\pipename という形式のパイプ名です。 注を参照。

Options

ネットワーク オプションの null で終わる文字列表現へのポインター。 オプション文字列はプロトコル シーケンスに関連付けられます。 注を参照。

StringBinding

バインド ハンドルの null で終わる文字列表現へのポインターへのポインターを返します。

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

メモ 詳細については、「 文字列バインディング」を参照してください。
 

戻り値

意味
RPC_S_OK
呼び出しは成功しました。
RPC_S_INVALID_STRING_UUID
UUID の文字列表現が無効です。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

注釈

アプリケーションは RpcStringBindingCompose ルーチンを 呼び出して、オブジェクト UUID、プロトコル シーケンス、ネットワーク アドレス、エンドポイント、その他のネットワーク オプションをバインド ハンドルの文字列表現に結合します。

RPC ランタイム ライブラリは、 StringBinding パラメーターで返される文字列にメモリを割り当てます。 アプリケーションは、 RpcStringFree を呼び出してそのメモリの割り当てを解除する役割を担います。

null パラメーター値を指定するか、データのない入力文字列ごとに空の文字列 (\0) を指定します。

C 言語文字列内のリテラル円記号文字は引用符で囲む必要があります。 ncacn_np プロトコル シーケンスのサーバー名の実際の C 文字列は \\servername として表示され、パイプ名の実際の C 文字列は \pipe\pipename として表示されます。

要件

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

こちらもご覧ください

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree