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
返されるコンテキストの属性を指定します。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 意味 |
|---|---|
|
pBuffer パラメーターには、SecPkgContext_AccessToken構造体へのポインターが含まれています。
アクセス トークンへのハンドルを返します。 |
|
pBuffer パラメーターには、SecPkgContext_SessionAppData構造体へのポインターが含まれています。
セッションのアプリケーション データを返すか指定します。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、SecPkgContext_Authority構造体へのポインターが含まれています。
認証機関の名前を照会します。 |
|
pBuffer パラメーターには、クライアントによって提供される初期ターゲットのサービス プリンシパル名 (SPN) を表すSecPkgContext_ClientSpecifiedTarget構造体へのポインターが含まれています。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。 |
|
pBuffer パラメーターには、SecPkgContext_ConnectionInfo構造体へのポインターが含まれています。
確立された接続に関する詳細情報を返します。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
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: この値はサポートされていません。 |
|
pBuffer パラメーターには、SecPkgContext_DceInfo構造体へのポインターが含まれています。
DCE サービスで使用される承認データのクエリ。 |
|
pBuffer パラメーターには、チャネル バインド情報を指定するSecPkgContext_Bindings構造体へのポインターが含まれています。
この属性は、Schannel セキュリティ パッケージでのみサポートされます。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。 |
|
pBuffer パラメーターには、SecPkgContext_EapKeyBlock構造体へのポインターが含まれています。
EAP TLS プロトコルで使用されるキー データのクエリ。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、SecPkgContext_Flags構造体へのポインターが含まれています。
ネゴシエートされたコンテキスト フラグに関する情報を返します。 |
|
pBuffer パラメーターには、SecPkgContext_IssuerListInfoEx構造体へのポインターが含まれています。
サーバーで受け入れられる証明書発行者の一覧を返します。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、SecPkgContext_KeyInfo構造体へのポインターが含まれています。
セキュリティ コンテキストで使用されるキーに関する情報を照会します。 |
|
pBuffer パラメーターには、InitializeSecurityContext 関数の最新の呼び出しからのトークンがクライアントからの最後のトークンであるかどうかを指定するSecPkgContext_LastClientTokenStatus構造体へのポインターが含まれています。
この値は、Negotiate、Kerberos、NTLM の各セキュリティ パッケージでのみサポートされます。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。 |
|
pBuffer パラメーターには、SecPkgContext_Lifespan構造体へのポインターが含まれています。
コンテキストの有効期間を照会します。 |
|
pBuffer パラメーターには、PCCERT_CONTEXT構造体へのポインターが含まれています。
ローカルエンド証明書を含む証明書コンテキストを検索します。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、SecPkgContext_LocalCredentialInfo構造体へのポインターが含まれています。 (互換性のために残されています) SECPKG_ATTR_LOCAL_CERT_CONTEXTに置き換えられます。 |
|
pBuffer パラメーターには、SecPkgContext_Names構造体へのポインターが含まれています。
コンテキストに関連付けられている名前を照会します。 |
|
pBuffer パラメーターには、SecPkgContext_NativeNames構造体へのポインターが含まれています。
送信チケットからプリンシパル名 (CNAME) を返します。 |
|
pBuffer パラメーターには、SecPkgContext_NegotiationInfo構造体へのポインターが含まれています。
ネゴシエーション プロセスで使用されるセキュリティ パッケージと、そのパッケージを使用するためのネゴシエーションの現在の状態に関する情報を返します。 |
|
pBuffer パラメーターには、SecPkgContext_PackageInfo構造体へのポインターが含まれています。
使用中の SSP に関する情報を返します。 |
|
pBuffer パラメーターには、SecPkgContext_PasswordExpiry構造体へのポインターが含まれています。
パスワードの有効期限情報を返します。 |
|
pBuffer パラメーターには、PCCERT_CONTEXT構造体へのポインターが含まれています。
サーバーによって提供される終了証明書を含む証明書コンテキストを検索します。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、HCERTCONTEXT へのポインターが含まれています。 ルート ストアによって提供される証明書を含む証明書コンテキストを検索します。 |
|
pBuffer パラメーターには、SecPkgContext_SessionKey構造体へのポインターが含まれています。
セッション キーに関する情報を返します。 |
|
pBuffer パラメーターには、SecPkgContext_SessionInfo構造体へのポインターが含まれています。
セッションに関する情報を返します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、SecPkgContext_Sizes構造体へのポインターが含まれています。
メッセージごとの関数で使用される構造体のサイズを照会します。 |
|
pBuffer パラメーターには、SecPkgContext_StreamSizes構造体へのポインターが含まれています。
メッセージごとの関数で使用されるストリームのさまざまな部分のサイズを照会します。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、SecPkgContext_SubjectAttributes構造体へのポインターが含まれています。
この値は、接続のセキュリティ属性に関する情報を返します。 この値は CredSSP サーバーでのみサポートされます。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。 |
|
pBuffer パラメーターには、SecPkgContext_SupportedSignatures構造体へのポインターが含まれています。
この値は、接続でサポートされている署名の種類に関する情報を返します。 この値は、Schannel セキュリティ パッケージでのみサポートされます。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。 |
|
pBuffer パラメーターには、SecPkgContext_TargetInformation構造体へのポインターが含まれています。
リモート サーバーの名前に関する情報を返します。 |
|
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 |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示