RpcNsEntryObjectInqBeginA 関数 (rpcnsi.h)

  • [アーティクル]

RpcNsEntryObjectInqBegin 関数は、ネーム サービス データベース エントリのオブジェクトの照会コンテキストを作成します。

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

構文

RPC_STATUS RpcNsEntryObjectInqBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_NS_HANDLE *InquiryContext
);

パラメーター

EntryNameSyntax

EntryName で使用する構文。

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

EntryName

オブジェクト UUID を表示する name-service データベース エントリ名へのポインター。

InquiryContext

RpcNsEntryObjectInqNext 関数と RpcNsEntryObjectInqDone 関数で使用する名前サービス ハンドルへのポインターを返します。

戻り値

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

注釈

RpcNsEntryObjectInqBegin 関数は、EntryName にエクスポートされたオブジェクト UUID を表示するための照会コンテキストを作成します。

RpcNsEntryObjectInqNext 関数を呼び出す前に、アプリケーションはまず RpcNsEntryObjectInqBegin を呼び出して照会コンテキストを作成する必要があります。

オブジェクト UUID の表示が完了すると、アプリケーションは RpcNsEntryObjectInqDone 関数を呼び出して照会コンテキストを削除します。

注意

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

要件

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

こちらもご覧ください

RpcNsBindingExport

RpcNsEntryObjectInqDone

RpcNsEntryObjectInqNext