RpcStringBindingComposeW 関数 (rpcdce.h)
RpcStringBindingCompose 関数は、文字列バインディング ハンドルを作成します。
構文
RPC_STATUS RpcStringBindingComposeW(
RPC_WSTR ObjUuid,
RPC_WSTR ProtSeq,
RPC_WSTR NetworkAddr,
RPC_WSTR Endpoint,
RPC_WSTR Options,
RPC_WSTR *StringBinding
);
パラメーター
ObjUuid
UUID
ProtSeq
プロトコル シーケンスの -terminated 文字列表現
NetworkAddr
ネットワーク アドレスの終端文字列表現null
Endpoint
エンドポイントの -terminated 文字列表現
Options
null-terminated 文字列形式のネットワーク オプションへのポインター。 オプション文字列はプロトコル シーケンスに関連付けられています。 「注」を参照してください。
StringBinding
バインド ハンドルの終端文字列表現、
RpcStringBindingCompose が StringBinding パラメーターを返さないように、NULL 値を指定します。 この場合、アプリケーションは RpcStringFree
戻り値
| 価値 | 意味 |
|---|---|
|
呼び出しは成功しました。 |
|
UUID の文字列形式が無効です。 |
備考
アプリケーション RpcStringBindingCompose ルーチンを呼び出して、オブジェクト UUID、プロトコル シーケンス、ネットワーク アドレス、エンドポイント、その他のネットワーク オプションをバインド ハンドルの文字列表現に結合します。
RPC ランタイム ライブラリは、StringBinding パラメーターで返される文字列にメモリを割り当てます。 アプリケーションは、RpcStringFree
null パラメーター値を指定するか、データのない各入力文字列に空の文字列 (\0) を指定します。
C 言語文字列内のリテラル円記号は引用符で囲む必要があります。 ncacn_np プロトコル シーケンスのサーバー名の実際の C 文字列は \\servername として表示され、パイプ名の実際の C 文字列は \pipe\pipename として表示されます。
手記
rpcdce.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RpcStringBindingCompose を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | rpcdce.h (Rpc.h を含む) |
| ライブラリ | Rpcrt4.lib |
| DLL | Rpcrt4.dll |
関連項目
RpcBindingToStringBinding の
RpcStringBindingParse の
RpcStringFree を