RpcNsBindingImportBeginA 関数 (rpcnsi.h)

  • [アーティクル]

RpcNsBindingImportBegin 関数は、指定されたインターフェイスとオブジェクトを提供するサーバーに対してクライアント互換のバインド ハンドルをインポートするためのインポート コンテキストを作成します。

メモ この関数は、Windows Vista 以降のオペレーティング システムではサポートされていません。
 

構文

RPC_STATUS RpcNsBindingImportBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      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 関数で使用するために返される名前サービス ハンドル。

戻り値

値 説明
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INVALID_NAME_SYNTAX
 名前の構文が無効です。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名前が最大長を超えています。
RPC_S_UNSUPPORTED_NAME_SYNTAX
 名前の構文はサポートされていません。
RPC_S_INCOMPLETE_NAME
 名前が不完全です。
RPC_S_ENTRY_NOT_FOUND
 name-service エントリが見つかりませんでした。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名前サービスを利用できません。
RPC_S_INVALID_OBJECT
 オブジェクトが無効です。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

解説

RpcNsBindingImportNext 関数を呼び出す前に、クライアント アプリケーションで最初に RpcNsBindingImportBegin を呼び出してインポート コンテキストを作成する必要があります。 この関数のパラメーターは 、RpcNsBindingImportNext 関数の操作を制御します。

バインド ハンドルのインポートが完了すると、クライアント アプリケーションは RpcNsBindingImportDone 関数を 呼び出してインポート コンテキストを削除します。

注意

rpcnsi.h ヘッダーは、RPCNsBindingImportBegin をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

RpcNsBindingImportDone

RpcNsBindingImportNext