RpcNsBindingInqEntryName 関数は、バインド ハンドルの取得元のエントリ名を返します。
注 この機能は、Windows Vista 以降のオペレーティング システムではサポートされていません。
構文
RPC_STATUS RpcNsBindingInqEntryNameA(
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
バインド が見つかった名前サービス データベース エントリの名前へのポインターのアドレス
RpcNsBindingInqEntryName が EntryName パラメーターを返さないようにするには、null 値を指定します。 この場合、アプリケーションは RpcStringFree 関数を呼び出しません。
戻り値
| 価値 | 意味 |
|---|---|
|
呼び出しは成功しました。 |
|
バインド ハンドルが無効でした。 |
|
バインドのエントリ名がありません。 |
|
名前の構文が無効です。 |
|
名前の構文はサポートされていません。 |
|
名前が不完全です。 |
注 有効なエラー コードの一覧については、「RPC 戻り値」を参照してください。
備考
RpcNsBindingInqEntryName 関数は、クライアントと互換性のあるバインディング ハンドルが存在する name service-database エントリ名の名前を返します。
RPC ランタイム ライブラリは、EntryName パラメーターで返される文字列にメモリを割り当てます。 アプリケーションは、RpcStringFree 関数を呼び出して、そのメモリの割り当てを解除する役割を担います。
エントリ名は、
手記
rpcdce.h ヘッダーは、RpcNsBindingInqEntryName を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | rpcdce.h (Rpc.h を含む) |
| ライブラリ | Rpcrt4.lib |
| DLL | Rpcrt4.dll |
関連項目
RpcNsBindingImportNext の
RpcStringFree を