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 結構的指標。
會傳回或指定工作階段的應用程式資料。 只有安全通道安全性套件才支援這個屬性。 |
|
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 結構的指標。
這個值會傳回連線所支援之簽章類型的相關信息。 只有安全通道安全性套件才支援此值。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支援此值。 |
|
pBuffer 參數包含 SecPkgContext_TargetInformation 結構的指標。
傳回遠端伺服器名稱的相關信息。 |
|
pBuffer 參數包含指定通道系結資訊之 SecPkgContext_Bindings 結構的指標。
只有安全通道安全性套件才支援此值。 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 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | sspi.h （include Security.h） |
| 連結庫 | Secur32.lib |
| DLL | Secur32.dll |