次の方法で共有

RpcBindingInqAuthInfoExA 関数 (rpcdce.h)

  • [アーティクル]

RpcBindingInqAuthInfoEx 関数は、バインディング ハンドルから認証、承認、およびセキュリティのサービス品質情報を返します。

構文

RPC_STATUS RpcBindingInqAuthInfoExA(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc,
  unsigned long            RpcQosVersion,
  RPC_SECURITY_QOS         *SecurityQOS
);

パラメーター

Binding

認証と承認の情報が返されるサーバー バインド ハンドル。

ServerPrincName

バインドで参照されるサーバーの予想されるプリンシパル名へのポインター 返します。 返される名前とその構文の内容は、使用中の認証サービスによって定義されます。

RpcBindingInqAuthInfoEx が ServerPrincName パラメーターを返さないようにするには、null 値を指定します。 この場合、アプリケーションは RpcStringFree 関数を呼び出しません。

AuthnLevel

バインディングを使用して行われたリモート プロシージャ コールに使用される認証レベルに設定されたポインターを返します。 RPC でサポートされる認証レベルの一覧については、「Authentication-Level 定数の」を参照してください。 関数が AuthnLevel パラメーターを返さないようにするには、null 値を指定します。

AuthnLevel パラメーターで返されるレベルは、クライアントが RpcBindingSetAuthInfoEx 関数を呼び出したときに指定したレベルとは異なる場合があります。 この不一致は、RPC ランタイム ライブラリがクライアントによって指定された認証レベルをサポートせず、次の上位の認証レベルに自動的にアップグレードされる場合に発生します。

AuthnSvc

Bindingを使用して行われたリモート プロシージャ コールに指定された認証サービスに設定されたポインターを返します。 RPC でサポートされる認証サービスの一覧については、「Authentication-Service 定数の」を参照してください。

RpcBindingInqAuthInfoEx が AuthnSvc パラメーターを返さないようにするには、null 値を指定します。

AuthIdentity

Bindingを使用して行われたリモート プロシージャ コールに対して指定されたクライアントの認証資格情報と承認資格情報を含むデータ構造へのハンドルへのポインターを返します。

RpcBindingInqAuthInfoEx が AuthIdentity パラメーターを返さないようにするには、null 値を指定します。

AuthzSvc

バインドでリモート プロシージャ 呼び出しを行ったクライアント アプリケーションによって要求された承認サービスに設定 ポインターを返します。 RPC でサポートされる認証サービスの一覧については、「Authentication-Service 定数の」を参照してください。

RpcBindingInqAuthInfoEx が AuthzSvc パラメーターを返さないようにするには、null 値を指定します。

RpcQosVersion

現在のバージョンの値を渡します (拡張機能がこの関数に対して行われる場合、前方互換性のために必要)。 このパラメーターは常にRPC_C_SECURITY_QOS_VERSIONに設定してください。

SecurityQOS

サービス品質の設定を定義する RPC_SECURITY_QOS 構造体へのポインターを返します。

戻り値

価値 意味
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INVALID_BINDING
 バインド ハンドルが無効でした。
RPC_S_WRONG_KIND_OF_BINDING
 これは、操作のバインドの種類が間違っていました。
RPC_BINDING_HAS_NO_AUTH
 バインディングには認証情報がありません。
 
注 有効なエラー コードの一覧については、「RPC 戻り値」を参照してください。
 

備考

クライアント アプリケーションは、RpcBindingInqAuthInfoEx 関数を呼び出して、サーバー バインド ハンドルに関連付けられている認証と承認の情報を表示します。 この関数は、バインディング ハンドルのサービスのセキュリティ品質を照会する機能を提供します。 それ以外の場合は、RpcBindingInqAuthInfoと同じです。

RPC ランタイム ライブラリは、返された ServerPrincName パラメーターにメモリを割り当てます。 アプリケーションは、返された引数文字列 RpcStringFree 関数を呼び出す役割を担います。

手記

rpcdce.h ヘッダーは、RpcBindingInqAuthInfoEx を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー rpcdce.h (Rpc.h を含む)
ライブラリ Rpcrt4.lib
DLL Rpcrt4.dll

関連項目

RPC_SECURITY_QOS

RpcBindingSetAuthInfoEx の

RpcStringFree を する