RpcNsBindingInqEntryNameW 関数 (rpcdce.h)

RpcNsBindingInqEntryName 関数は、バインド ハンドルの取得元のエントリ名を返します。

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

構文

RPC_STATUS RpcNsBindingInqEntryNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_WSTR           *EntryName
);

パラメーター

Binding

name-service データベース エントリ名が返されるバインド ハンドル。

EntryNameSyntax

EntryName で使用される構文。

レジストリ値エントリで指定された構文を使用するには

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax、RPC_C_NS_SYNTAX_DEFAULTの値を指定します。

EntryName

Binding が見つかった name-service データベース エントリの名前へのポインターのアドレスを返します。

RpcNsBindingInqEntryNameEntryName パラメーターを返さないようにするには、null 値を指定します。 この場合、アプリケーションは RpcStringFree 関数を呼び出しません。

戻り値

説明
RPC_S_OK
呼び出しは成功しました。
RPC_S_INVALID_BINDING
バインド ハンドルが無効です。
RPC_S_NO_ENTRY_NAME
バインドのエントリ名がありません。
RPC_S_INVALID_NAME_SYNTAX
名前の構文が無効です。
RPC_S_UNSUPPORTED_NAME_SYNTAX
名前の構文はサポートされていません。
RPC_S_INCOMPLETE_NAME
名前が不完全です。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

解説

RpcNsBindingInqEntryName 関数は、クライアント互換バインディング ハンドルが存在する service-database エントリ名の名前を返します。

RPC ランタイム ライブラリは 、EntryName パラメーターで返される文字列にメモリを割り当てます。 アプリケーションは、 RpcStringFree 関数を呼び出してそのメモリの割り当てを解除する役割を担います。

エントリ名は、RpcNsBindingImportNext、RpcNsBindingLookupNext、および RpcNsBindingSelect 関数から返されるバインド ハンドルにのみ関連付けられます。

Binding パラメーターで指定されたバインド ハンドルがネーム サービス データベース エントリから返されなかった場合 (たとえば、バインド ハンドルが RpcBindingFromStringBinding を呼び出して作成された場合)、RpcNsBindingInqEntryName は空の文字列 ("\0") とRPC_S_NO_ENTRY_NAME状態コードを返します。

注意

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

要件

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

関連項目

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree