RpcBindingInqAuthInfo 関数 (rpcdce.h)
RpcBindingInqAuthInfo 関数は、バインド ハンドルから認証と承認の情報を返します。
構文
RPC_STATUS RpcBindingInqAuthInfo(
RPC_BINDING_HANDLE Binding,
RPC_CSTR *ServerPrincName,
unsigned long *AuthnLevel,
unsigned long *AuthnSvc,
RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
unsigned long *AuthzSvc
);
パラメーター
Binding
認証と承認の情報が返されるサーバー バインド ハンドル。
ServerPrincName
Binding で参照されているサーバーの予想されるプリンシパル名へのポインターへのポインターを返します。 返される名前の内容とその構文は、使用中の認証サービスによって定義されます。
RpcBindingInqAuthInfo が ServerPrincName パラメーターを返さないようにするには、null 値を指定します。 この場合、アプリケーションは RpcStringFree 関数を呼び出しません。
AuthnLevel
Binding を使用して行われたリモート プロシージャ 呼び出しに使用される認証のレベルに設定されたポインターを返します。 注を参照。
関数が AuthnLevel パラメーターを返さないようにするには、null 値を指定します。
AuthnLevel パラメーターで返されるレベルは、クライアントが RpcBindingSetAuthInfo 関数を呼び出したときに指定されたレベルとは異なる場合があります。 この不一致は、RPC ランタイム ライブラリがクライアントによって指定された認証レベルをサポートせず、次の上位の認証レベルに自動的にアップグレードされる場合に発生します。
AuthnSvc
Binding を使用して行われたリモート プロシージャ 呼び出しに指定された認証サービスに設定されたポインターを返します。 注を参照。
RpcBindingInqAuthInfo が AuthnSvc パラメーターを返さないようにするには、null 値を指定します。
AuthIdentity
Binding を使用して行われたリモート プロシージャ 呼び出しに対して指定されたクライアントの認証資格情報と承認資格情報を含むデータ構造へのハンドルへのポインターを返します。
RpcBindingInqAuthInfo が AuthIdentity パラメーターを返さないようにするには、null 値を指定します。
AuthzSvc
バインディングのリモート プロシージャ 呼び出しを行ったクライアント アプリケーションによって要求された承認サービスに設定されたポインターを返します 。 注を参照してください。
RpcBindingInqAuthInfo が AuthzSvc パラメーターを返さないようにするには、null 値を指定します。
戻り値
| 値 | 説明 |
|---|---|
|
呼び出しは成功しました。 |
|
バインド ハンドルが無効です。 |
|
これは、操作のバインドの種類が間違っていました。 |
|
バインドには認証情報がありません。 |
解説
クライアント アプリケーションは RpcBindingInqAuthInfo 関数を 呼び出して、サーバー バインド ハンドルに関連付けられている認証と承認の情報を表示します。 同様の関数 RpcBindingInqAuthInfoEx は、バインド ハンドルに関するセキュリティのサービス品質情報も提供します。
RPC ランタイム ライブラリは、返された ServerPrincName パラメーターにメモリを割り当てます。 アプリケーションは、返された引数文字列に対して RpcStringFree 関数を呼び出す役割を担います。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rpcdce.h (Rpc.h を含む) |
| Library | Rpcrt4.lib |
| [DLL] | Rpcrt4.dll |