次の方法で共有

RpcNsBindingExportPnPA 関数 (rpcnsi.h)

  • [アーティクル]

RpcNsBindingExportPnP 関数は、プラグ アンド プレイをサポートするサーバーに対して、複数のバインド ハンドルと複数のオブジェクトを持つネーム サービス データベース エントリを確立します。

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

構文

RPC_STATUS RpcNsBindingExportPnPA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID_VECTOR   *ObjectVector
);

パラメーター

EntryNameSyntax

EntryNameの構文。

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

EntryName

バインド ハンドルとオブジェクト UUID がエクスポートされるエントリ名へのポインター。 null または空の文字列を指定することはできません。

レジストリ値エントリ HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntryで指定されたエントリ名を使用するには、null ポインターまたは空の文字列を指定します。 この場合、EntryNameSyntax パラメーターは無視され、ランタイム ライブラリでは既定の構文が使用されます。

IfSpec

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

ObjectVector

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

戻り値

価値 意味
RPC_S_OK
 呼び出しは成功しました。
RPC_S_NOTHING_TO_EXPORT
 エクスポートするものはありませんでした。
RPC_S_INVALID_BINDING
 バインド ハンドルが無効でした。
RPC_S_WRONG_KIND_OF_BINDING
 これは、操作のバインドの種類が間違っていました。
RPC_S_INVALID_NAME_SYNTAX
 名前の構文が無効です。
RPC_S_UNSUPPORTED_NAME_SYNTAX
 名前の構文はサポートされていません。
RPC_S_INCOMPLETE_NAME
 名前が不完全です。
RPC_S_NO_NS_PRIVILEGE
 名前サービス操作に対する特権はありません。
RPC_S_NAME_SERVICE_UNAVAILABLE
 ネーム サービスは使用できません。
 
注 有効なエラー コードの一覧については、「RPC 戻り値」を参照してください。
 

備考

RpcNsBindingExportPnP 関数を使用すると、サーバー アプリケーションは、任意のクライアント アプリケーションで使用するプラグ アンド プレイ バインドをサポートする名前サービス データベース内のインターフェイスをパブリックに提供できます。

サーバー アプリケーションは、プラグ アンド プレイ バインドをエクスポートするときにバインド ベクターを明示的に指定しないでください。 プラグ アンド プレイ イベントが原因でバインディングに変更が加えられると、バインドが自動的に更新されます。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー rpcnsi.h (Rpc.h を含む)
ライブラリ Rpcns4.lib
DLL Rpcns4.dll

関連項目

RpcNsBindingExport の

RpcNsBindingUnexportPnP の