RpcNsBindingExportA 関数 (rpcnsi.h)

RpcNsBindingExport 関数は、サーバーの複数のバインド ハンドルと複数のオブジェクトを持つネーム サービス-データベース エントリを確立します。

構文

RPC_STATUS RpcNsBindingExportA(
  unsigned long      EntryNameSyntax,
  RPC_CSTR           EntryName,
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVec,
  UUID_VECTOR        *ObjectUuidVec
);

パラメーター

EntryNameSyntax

EntryNameの構文。

レジストリ値エントリ HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxで指定された構文を使用するには、RPC_C_NS_SYNTAX_DEFAULTの値を指定します。

EntryName

バインド ハンドルとオブジェクト UUID がエクスポートされるエントリ名へのポインター。 null または空の文字列を指定することはできません。 クライアントとサーバーの両方で同じエントリ名を使用する必要があります。

IfSpec

エクスポートするインターフェイスを指定するスタブ生成データ構造。 null 値は、エクスポートするバインド ハンドルがないことを示し (オブジェクト UUID のみがエクスポートされます)、BindingVec は無視されます。

BindingVec

エクスポートするサーバー バインドへのポインター。 null 値は、エクスポートするバインド ハンドルがないことを示します (オブジェクト UUID のみがエクスポートされます)。

ObjectUuidVec

サーバーによって提供されるオブジェクト UUID のベクトルへのポインター。 サーバー アプリケーションはこのベクトルを構築します。 null 値は、エクスポートするオブジェクト UUID がないことを示します (バインド ハンドルのみがエクスポートされます)。

戻り値

備考

RpcNsBindingExport 関数を使用すると、サーバー アプリケーションは、任意のクライアント アプリケーションで使用するために、ネーム サービス データベース内のインターフェイスをパブリックに提供できます。

Windows 2000 で有効な RPC ランタイム環境では、Active Directory を名前サービス データベースとして使用します。 つまり、承認されたエクスポートされたエントリはネーム サービスに保持され、再起動後も表示されます。 承認されていないエクスポートは保持されません。 承認とアクセス制御リストの詳細については、「プラットフォーム ソフトウェア開発キット (SDK) のセキュリティ」セクションの「アクセス制御の」を参照してください。

インターフェイスをエクスポートするために、サーバー アプリケーションはインターフェイスを使用して RpcNsBindingExport ルーチンを呼び出し、サーバー バインドはクライアントがサーバーへのアクセスに使用できる処理を処理します。 サーバー アプリケーションは、RpcNsBindingExport 関数を呼び出して、提供するリソースのオブジェクト UUID (存在する場合) をネーム サービス データベースにパブリックに提供します。

サーバーは、RpcNsBindingExportを する 1 回の呼び出しでインターフェイスとオブジェクトをエクスポートすることも、個別にエクスポートすることもできます。EntryName で指定された名前サービス データベース エントリが存在しない場合は、RpcNsBindingExport が作成を試みます。 この場合、サーバー アプリケーションはエントリを作成する権限を持っている必要があります。RpcNsBindingExport呼び出すことに加えて、RpcServerUseAllProtseqs または RpcServerUseProtseq 関数 を呼び出したサーバーは、RpcEpRegister または RpcEpRegisterNoReplaceを呼び出してローカル エンドポイント マップ データベースに登録する必要があります。

サーバーは、そのインターフェイスをネーム サービス データベースにエクスポートする必要はありません。 サーバーがエクスポートしない場合、サーバーのバインディング情報がプライベートに認識されているクライアントのみが、そのインターフェイスにアクセスできます。 たとえば、文字列バインディングを構築するために必要な情報を持つクライアントは、RpcBindingFromStringBinding を呼び出して、サーバーへのリモート プロシージャ呼び出しを行うバインディング ハンドルを作成できます。

RpcNsBindingExport呼び出す前に、サーバーで次の操作を行う必要があります。

• 次のいずれかの関数を呼び出して、1 つ以上のプロトコル シーケンスをローカル RPC ランタイム ライブラリに登録します。
  • RpcServerUseAllProtseqs、 RpcServerUseAllProtseqsEx
  • RpcServerUseProtseq、 RpcServerUseProtseqEx
  • RpcServerUseAllProtseqsIf, RpcServerUseAllProtseqsIfEx
  • RpcServerUseProtseqIf、RpcServerUseProtseqIf
  • RpcServerUseProtseqEp、RpcServerUseProtseqEp
• RpcServerInqBindings 関数を呼び出して、サーバー バインドの一覧を取得します。