RpcNsBindingInqEntryNameW 関数 (rpcdce.h)
RpcNsBindingInqEntryName 関数は、バインド ハンドルの取得元のエントリ名を返します。
構文
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 データベース エントリの名前へのポインターのアドレスを返します。
RpcNsBindingInqEntryName が EntryName パラメーターを返さないようにするには、null 値を指定します。 この場合、アプリケーションは RpcStringFree 関数を呼び出しません。
戻り値
| 値 | 説明 |
|---|---|
|
呼び出しは成功しました。 |
|
バインド ハンドルが無効です。 |
|
バインドのエントリ名がありません。 |
|
名前の構文が無効です。 |
|
名前の構文はサポートされていません。 |
|
名前が不完全です。 |
解説
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 |