次の方法で共有

QueryContextAttributesExW 関数 (sspi.h)

  • [アーティクル]

トランスポート アプリケーションがセキュリティ コンテキストの特定の属性についてセキュリティ パッケージに対してクエリを実行できるようにします。

構文

SECURITY_STATUS SEC_ENTRY QueryContextAttributesExW(
  [in]  PCtxtHandle   phContext,
  [in]  unsigned long ulAttribute,
  [out] void          *pBuffer,
  [in]  unsigned long cbBuffer
);

パラメーター

[in] phContext

クエリを実行するセキュリティ コンテキストへのハンドル。

[in] ulAttribute

返されるコンテキストの属性を指定します。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
SECPKG_ATTR_ACCESS_TOKEN
18
 pBuffer パラメーターには、SecPkgContext_AccessToken構造体へのポインターが含まれています。

アクセス トークンへのハンドルを返します。
SECPKG_ATTR_APP_DATA
0x5e
 pBuffer パラメーターには、SecPkgContext_SessionAppData構造体へのポインターが含まれています。

セッションのアプリケーション データを返すか指定します。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。
SECPKG_ATTR_AUTHORITY
6
 pBuffer パラメーターには、SecPkgContext_Authority構造体へのポインターが含まれています。

認証機関の名前を照会します。
SECPKG_ATTR_CLIENT_SPECIFIED_TARGET
27
 pBuffer パラメーターには、クライアントによって提供される初期ターゲットのサービス プリンシパル名 (SPN) を表すSecPkgContext_ClientSpecifiedTarget構造体へのポインターが含まれています。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。
SECPKG_ATTR_CONNECTION_INFO
0x5a
 pBuffer パラメーターには、SecPkgContext_ConnectionInfo構造体へのポインターが含まれています。

確立された接続に関する詳細情報を返します。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。
SECPKG_ATTR_CREDS_2
0x80000086
 pBuffer パラメーターには、クライアント資格情報を指定するSecPkgContext_ClientCreds構造体へのポインターが含まれています。

クライアント資格情報がユーザー名とパスワードの場合、バッファーはパック されたKERB_INTERACTIVE_LOGON 構造です。

クライアント資格情報がユーザー名とスマート カード PIN の場合、バッファーはパックされたKERB_CERTIFICATE_LOGON構造になります。

クライアント資格情報がオンライン ID 資格情報の場合、バッファーはマーシャリング されたSEC_WINNT_AUTH_IDENTITY_EX2 構造体です。

この属性は CredSSP サーバーでのみサポートされます。

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。
SECPKG_ATTR_DCE_INFO
3
 pBuffer パラメーターには、SecPkgContext_DceInfo構造体へのポインターが含まれています。

DCE サービスで使用される承認データのクエリ。
SECPKG_ATTR_ENDPOINT_BINDINGS
26
 pBuffer パラメーターには、チャネル バインド情報を指定するSecPkgContext_Bindings構造体へのポインターが含まれています。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。
SECPKG_ATTR_EAP_KEY_BLOCK
0x5b
 pBuffer パラメーターには、SecPkgContext_EapKeyBlock構造体へのポインターが含まれています。

EAP TLS プロトコルで使用されるキー データのクエリ。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。
SECPKG_ATTR_FLAGS
14
 pBuffer パラメーターには、SecPkgContext_Flags構造体へのポインターが含まれています。

ネゴシエートされたコンテキスト フラグに関する情報を返します。
SECPKG_ATTR_ISSUER_LIST_EX
0x59
 pBuffer パラメーターには、SecPkgContext_IssuerListInfoEx構造体へのポインターが含まれています。

サーバーで受け入れられる証明書発行者の一覧を返します。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。
SECPKG_ATTR_KEY_INFO
5
 pBuffer パラメーターには、SecPkgContext_KeyInfo構造体へのポインターが含まれています。

セキュリティ コンテキストで使用されるキーに関する情報を照会します。
SECPKG_ATTR_LAST_CLIENT_TOKEN_STATUS
30
 pBuffer パラメーターには、InitializeSecurityContext 関数の最新の呼び出しからのトークンがクライアントからの最後のトークンであるかどうかを指定するSecPkgContext_LastClientTokenStatus構造体へのポインターが含まれています。

この値は、Negotiate、Kerberos、NTLM の各セキュリティ パッケージでのみサポートされます。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。
SECPKG_ATTR_LIFESPAN
2
 pBuffer パラメーターには、SecPkgContext_Lifespan構造体へのポインターが含まれています。

コンテキストの有効期間を照会します。
SECPKG_ATTR_LOCAL_CERT_CONTEXT
0x54
 pBuffer パラメーターには、PCCERT_CONTEXT構造体へのポインターが含まれています。

ローカルエンド証明書を含む証明書コンテキストを検索します。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。
SECPKG_ATTR_LOCAL_CRED
 pBuffer パラメーターには、SecPkgContext_LocalCredentialInfo構造体へのポインターが含まれています。 (互換性のために残されています)

SECPKG_ATTR_LOCAL_CERT_CONTEXTに置き換えられます。
SECPKG_ATTR_NAMES
1
 pBuffer パラメーターには、SecPkgContext_Names構造体へのポインターが含まれています。

コンテキストに関連付けられている名前を照会します。
SECPKG_ATTR_NATIVE_NAMES
13
 pBuffer パラメーターには、SecPkgContext_NativeNames構造体へのポインターが含まれています。

送信チケットからプリンシパル名 (CNAME) を返します。
SECPKG_ATTR_NEGOTIATION_INFO
12
 pBuffer パラメーターには、SecPkgContext_NegotiationInfo構造体へのポインターが含まれています。

ネゴシエーション プロセスで使用されるセキュリティ パッケージと、そのパッケージを使用するためのネゴシエーションの現在の状態に関する情報を返します。
SECPKG_ATTR_PACKAGE_INFO
10
 pBuffer パラメーターには、SecPkgContext_PackageInfo構造体へのポインターが含まれています。

使用中の SSP に関する情報を返します。
SECPKG_ATTR_PASSWORD_EXPIRY
8
 pBuffer パラメーターには、SecPkgContext_PasswordExpiry構造体へのポインターが含まれています。

パスワードの有効期限情報を返します。
SECPKG_ATTR_REMOTE_CERT_CONTEXT
0x53
 pBuffer パラメーターには、PCCERT_CONTEXT構造体へのポインターが含まれています。

サーバーによって提供される終了証明書を含む証明書コンテキストを検索します。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。
SECPKG_ATTR_ROOT_STORE
0x55
 pBuffer パラメーターには、HCERTCONTEXT へのポインターが含まれています。 ルート ストアによって提供される証明書を含む証明書コンテキストを検索します。
SECPKG_ATTR_SESSION_KEY
9
 pBuffer パラメーターには、SecPkgContext_SessionKey構造体へのポインターが含まれています。

セッション キーに関する情報を返します。
SECPKG_ATTR_SESSION_INFO
0x5d
 pBuffer パラメーターには、SecPkgContext_SessionInfo構造体へのポインターが含まれています。

セッションに関する情報を返します。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。
SECPKG_ATTR_SIZES
0
 pBuffer パラメーターには、SecPkgContext_Sizes構造体へのポインターが含まれています。

メッセージごとの関数で使用される構造体のサイズを照会します。
SECPKG_ATTR_STREAM_SIZES
4
 pBuffer パラメーターには、SecPkgContext_StreamSizes構造体へのポインターが含まれています。

メッセージごとの関数で使用されるストリームのさまざまな部分のサイズを照会します。

この属性は、Schannel セキュリティ パッケージでのみサポートされます。
SECPKG_ATTR_SUBJECT_SECURITY_ATTRIBUTES
124
 pBuffer パラメーターには、SecPkgContext_SubjectAttributes構造体へのポインターが含まれています。

この値は、接続のセキュリティ属性に関する情報を返します。

この値は CredSSP サーバーでのみサポートされます。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。
SECPKG_ATTR_SUPPORTED_SIGNATURES
0x66
 pBuffer パラメーターには、SecPkgContext_SupportedSignatures構造体へのポインターが含まれています。

この値は、接続でサポートされている署名の種類に関する情報を返します。

この値は、Schannel セキュリティ パッケージでのみサポートされます。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。
SECPKG_ATTR_TARGET_INFORMATION
17
 pBuffer パラメーターには、SecPkgContext_TargetInformation構造体へのポインターが含まれています。

リモート サーバーの名前に関する情報を返します。
SECPKG_ATTR_UNIQUE_BINDINGS
25
 pBuffer パラメーターには、チャネル バインド情報を指定するSecPkgContext_Bindings構造体へのポインターが含まれています。

この値は、Schannel セキュリティ パッケージでのみサポートされます。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。

[out] pBuffer

属性を受け取る構造体へのポインター。 指し示される構造体の型は、 ulAttribute パラメーターで指定された値によって異なります。

[in] cbBuffer

pBuffer パラメーターのサイズ (バイト単位)。

戻り値

関数が成功した場合、戻り値はSEC_E_OK。

関数が失敗した場合、戻り値は 0 以外のエラー コードになります。

注釈

注意

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー sspi.h (Security.h を含む)
Library Secur32.lib
[DLL] Secur32.dll

こちらもご覧ください

CERT_CONTEXT

FreeContextBuffer

SSPI 関数

SecPkgContext_Authority

SecPkgContext_ConnectionInfo

SecPkgContext_DceInfo

SecPkgContext_IssuerListInfoEx

SecPkgContext_KeyInfo

SecPkgContext_Lifespan

SecPkgContext_Names

SecPkgContext_Sizes

SecPkgContext_StreamSizes