QueryContextAttributesExA 函式 (sspi.h)
語法
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
參數
[in] phContext
要查詢之安全性內容的句柄。
[in] ulAttribute
指定要傳回之內容的屬性。 此參數可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
pBuffer 參數包含SecPkgContext_AccessToken結構的指標。
傳回存取令牌的句柄。 |
|
pBuffer 參數包含SecPkgContext_SessionAppData結構的指標。
會傳回或指定工作階段的應用程式資料。 只有安全通道安全性套件才支援這個屬性。 |
|
pBuffer 參數包含SecPkgContext_Authority結構的指標。
查詢驗證授權單位的名稱。 |
|
pBuffer 參數包含SecPkgContext_ClientSpecifiedTarget結構的指標，代表用戶端提供之初始目標 (SPN ) 的服務主體名稱。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。 |
|
pBuffer 參數包含SecPkgContext_ConnectionInfo結構的指標。
傳回已建立連線的詳細資訊。 只有安全通道安全性套件才支援這個屬性。 |
|
pBuffer 參數包含指定客戶端認證的SecPkgContext_ClientCreds結構的指標。
如果客戶端認證是使用者名稱和密碼，則緩衝區是封裝 KERB_INTERACTIVE_LOGON 結構。 如果客戶端認證是使用者名稱和智慧卡 PIN，則緩衝區是封裝 KERB_CERTIFICATE_LOGON 結構。 如果客戶端認證是在線身分識別認證，緩衝區會封送 處理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結構的指標。
只有安全通道安全性套件才支援這個屬性。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。 |
|
pBuffer 參數包含SecPkgContext_EapKeyBlock結構的指標。
查詢EAP TLS 通訊協定所使用的金鑰數據。 只有安全通道安全性套件才支援這個屬性。 |
|
pBuffer 參數包含SecPkgContext_Flags結構的指標。
傳回交涉內容旗標的相關信息。 |
|
pBuffer 參數包含SecPkgContext_IssuerListInfoEx結構的指標。
傳回伺服器接受的憑證簽發者清單。 只有安全通道安全性套件才支援這個屬性。 |
|
pBuffer 參數包含SecPkgContext_KeyInfo結構的指標。
查詢安全性內容中所用金鑰的相關信息。 |
|
pBuffer 參數包含SecPkgContext_LastClientTokenStatus結構的指標，指定最近呼叫 InitializeSecurityContext 函式的令牌是否為客戶端的最後一個令牌。
只有 Negotiate、Kerberos 和 NTLM 安全性套件才支援此值。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。 |
|
pBuffer 參數包含SecPkgContext_Lifespan結構的指標。
查詢內容生命週期。 |
|
pBuffer 參數包含PCCERT_CONTEXT結構的指標。
尋找包含本機端憑證的憑證內容。 只有安全通道安全性套件才支援這個屬性。 |
|
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結構的指標。
尋找包含伺服器提供之結束憑證的憑證內容。 只有安全通道安全性套件才支援這個屬性。 |
|
pBuffer 參數包含 HCERTCONTEXT 的指標。 尋找包含根存放區所提供之憑證的憑證內容。 |
|
pBuffer 參數包含SecPkgContext_SessionKey結構的指標。
傳回會話金鑰的相關信息。 |
|
pBuffer 參數包含SecPkgContext_SessionInfo結構的指標。
傳回會話的相關信息。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。 只有安全通道安全性套件才支援這個屬性。 |
|
pBuffer 參數包含SecPkgContext_Sizes結構的指標。
查詢每個訊息函式中使用的結構大小。 |
|
pBuffer 參數包含SecPkgContext_StreamSizes結構的指標。
查詢每個訊息函式中使用的數據流各種部分大小。 只有安全通道安全性套件才支援這個屬性。 |
|
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。
如果函式失敗，傳回值是非零錯誤碼。
備註
注意
sspi.h 標頭會根據 UNICODE 預處理器常數的定義，將 QueryContextAttributesEx 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | sspi.h (包含 Security.h) |
| 程式庫 | Secur32.lib |
| Dll | Secur32.dll |