RpcNsBindingImportBeginW 関数 (rpcnsi.h)
RpcNsBindingImportBegin 関数は、指定されたインターフェイスとオブジェクトを提供するサーバーに対して、クライアント互換のバインド ハンドルをインポートするためのインポート コンテキストを作成します。
構文
RPC_STATUS RpcNsBindingImportBeginW(
unsigned long EntryNameSyntax,
RPC_WSTR EntryName,
RPC_IF_HANDLE IfSpec,
UUID *ObjUuid,
RPC_NS_HANDLE *ImportContext
);
パラメーター
EntryNameSyntax
EntryName の構文。
HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxレジストリ値エントリで指定された構文 を 使用するには、RPC_C_NS_SYNTAX_DEFAULTを指定します。
EntryName
互換性のあるバインド ハンドルの検索が開始されるエントリ名へのポインター。
HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntryレジストリ 値エントリで 指定されたエントリ名を使用するには、null ポインターまたは空の文字列を指定します。 この場合、 EntryNameSyntax パラメーターは無視され、ランタイム ライブラリでは既定の構文が使用されます。
IfSpec
インポートするインターフェイスを示すスタブ生成データ構造。 インターフェイス仕様がエクスポートされていない場合、または呼び出し元に問題がない場合は、このパラメーターに null 値を指定します。 この場合、返されるバインディングは、互換性があり、サポートされているプロトコル シーケンスであり、指定されたオブジェクト UUID を含む必要があります。 接続されたサーバーが目的のインターフェイスをサポートしていない可能性があります。
ObjUuid
省略可能なオブジェクト UUID へのポインター。
0 以外の UUID の場合、互換性のあるバインド ハンドルは、サーバーが指定したオブジェクト UUID をエクスポートした場合にのみ、エントリから返されます。
ObjUuid に null ポインター値または nil UUID がある場合、返されるバインディング ハンドルには、互換性のあるサーバーによってエクスポートされたオブジェクト UUID のいずれかが含まれます。 サーバーがオブジェクト UUID をエクスポートしなかった場合、返される互換性のあるバインド ハンドルには nil オブジェクト UUID が含まれます。
ImportContext
RpcNsBindingImportNext 関数と RpcNsBindingImportDone 関数で使用するために返される名前サービス ハンドル。
戻り値
値 | 意味 |
---|---|
|
呼び出しは成功しました。 |
|
名前の構文が無効です。 |
|
名前が最大長を超えています。 |
|
名前の構文はサポートされていません。 |
|
名前が不完全です。 |
|
name-service エントリが見つかりませんでした。 |
|
名前サービスを利用できません。 |
|
オブジェクトが無効です。 |
注釈
RpcNsBindingImportNext 関数を呼び出す前に、クライアント アプリケーションはまず RpcNsBindingImportBegin を呼び出してインポート コンテキストを作成する必要があります。 この関数のパラメーターは、 RpcNsBindingImportNext 関数の操作を制御します。
バインド ハンドルのインポートが完了すると、クライアント アプリケーションは RpcNsBindingImportDone 関数を 呼び出してインポート コンテキストを削除します。
注意
rpcnsi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RpcNsBindingImportBegin を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | rpcnsi.h (Rpc.h を含む) |
Library | Rpcns4.lib |
[DLL] | Rpcns4.dll |