RpcNsBindingInqEntryName 関数 (rpcdce.h)

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

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

 

構文

RPC_STATUS RpcNsBindingInqEntryName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *EntryName
);

パラメーター

Binding

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

EntryNameSyntax

EntryName で使用される構文。

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

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

EntryName

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

RpcNsBindingInqEntryName が EntryName パラメーターを返さないようにするには、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状態コードを返します。

要件

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

こちらもご覧ください

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree