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 関数を呼び出す役割を担います。

要件

関連項目

RpcBindingInqAuthClient

RpcBindingInqAuthInfoEx

RpcBindingInqOption

RpcBindingSetAuthInfo

RpcStringFree