共用方式為

QueryCoNtextAttributes （一般） 函式

  • 發行項

可讓傳輸應用程式查詢 安全性套件 是否有安全性內容 的特定 屬性 。

如需搭配特定 安全性支援提供者 使用此函式的相關資訊，請參閱下列主題。

主題 說明
QueryCoNtextAttributes （CredSSP） 可讓傳輸應用程式查詢認證安全性支援提供者 （CredSSP） 以取得安全性內容 的特定屬性 。
QueryCoNtextAttributes （摘要） 可讓傳輸應用程式查詢摘要式安全性套件，以取得安全性內容 的特定屬性 。
QueryCoNtextAttributes （Kerberos） 可讓傳輸應用程式查詢 Kerberos 安全性套件是否有安全性內容 的特定屬性 。
QueryCoNtextAttributes （Negotiate） 可讓傳輸應用程式查詢交涉安全性套件是否有安全性內容 的特定屬性 。
QueryCoNtextAttributes （NTLM） 可讓傳輸應用程式查詢 NTLM 安全性套件是否有安全性內容 的特定屬性 。
QueryCoNtextAttributes （Schannel） 可讓傳輸應用程式查詢安全內容特定屬性的 安全通道安全性套件。

語法

SECURITY_STATUS SEC_ENTRY QueryContextAttributes(
  _In_  PCtxtHandle phContext,
  _In_  ULONG       ulAttribute,
  _Out_ PVOID       pBuffer
);

參數

phCoNtext [in]

要查詢之安全性內容的 控制碼 。

ulAttribute [in]

指定要傳回之內容的屬性。 此參數可以是下列其中一個值。

值 意義
SECPKG_ATTR_ACCESS_TOKEN
18
 pBuffer 參數包含SecPkgCoNtext_AccessToken 結構的指標 。
傳回存取權杖的控制碼。
SECPKG_ATTR_APP_DATA
0x5e
 pBuffer 參數包含SecPkgCoNtext_SessionAppData 結構的指標 。
會傳回或指定會話的應用程式資料。
只有安全通道 安全性套件 才支援這個屬性。
SECPKG_ATTR_AUTHORITY
6
 pBuffer 參數包含SecPkgCoNtext_Authority 結構的指標 。
查詢驗證授權單位的名稱。
SECPKG_ATTR_CLIENT_SPECIFIED_TARGET
27
 pBuffer 參數包含SecPkgCoNtext_ClientSpecifiedTarget 結構的指標 ，代表用戶端提供之初始目標的服務主體名稱 （SPN）。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。
SECPKG_ATTR_CONNECTION_INFO
0x5a
 pBuffer 參數包含 SecPkgCoNtext_連線ionInfo 結構的指標 。
傳回已建立連接的詳細資訊。
只有安全通道 安全性套件 才支援這個屬性。
SECPKG_ATTR_CREDS_2
0x80000086
 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 ：不支援此值。
SECPKG_ATTR_DCE_INFO
3
 pBuffer 參數包含SecPkgCoNtext_DceInfo 結構的指標 。
查詢 DCE 服務所使用的授權資料。
SECPKG_ATTR_ENDPOINT_BINDINGS
26
 pBuffer 參數包含指定通道系結資訊之SecPkgCoNtext_Bindings 結構的指標 。
只有安全通道 安全性套件 才支援這個屬性。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。
SECPKG_ATTR_EAP_KEY_BLOCK
0x5b
 pBuffer 參數包含SecPkgCoNtext_EapKeyBlock 結構的指標 。
查詢 EAP TLS 通訊協定所使用的金鑰資料。
只有安全通道 安全性套件 才支援這個屬性。
SECPKG_ATTR_FLAGS
14
 pBuffer 參數包含SecPkgCoNtext_Flags 結構的指標 。
傳回交涉內容旗標的相關資訊。
SECPKG_ATTR_ISSUER_LIST_EX
0x59
 pBuffer 參數包含SecPkgCoNtext_IssuerListInfoEx 結構的指標 。
傳回伺服器接受的憑證簽發者清單。
只有安全通道 安全性套件 才支援這個屬性。
SECPKG_ATTR_KEY_INFO
5
 pBuffer 參數包含SecPkgCoNtext_KeyInfo 結構的指標 。
查詢安全性內容 中使用的 金鑰相關資訊。
SECPKG_ATTR_LAST_CLIENT_TOKEN_STATUS
30
 pBuffer 參數包含SecPkgCoNtext_LastClientTokenStatus 結構的指標 ，指定來自最近呼叫 InitializeSecurityCoNtext 函式的權杖是否為用戶端的最後一個權杖。
此值僅受 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 結構的指標 。
尋找包含本機結束憑證的憑證內容。
只有安全通道 安全性套件 才支援這個屬性。
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 結構的指標 。
尋找包含伺服器提供之結束憑證的憑證內容。
只有安全通道 安全性套件 才支援這個屬性。
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： 不支援此值。
只有安全通道 安全性套件 才支援這個屬性。
SECPKG_ATTR_SIZES
0
 pBuffer 參數包含SecPkgCoNtext_Sizes 結構的指標 。
查詢每個訊息函式中使用的結構大小。
SECPKG_ATTR_STREAM_SIZES
4
 pBuffer 參數包含SecPkgCoNtext_StreamSizes 結構的指標 。
查詢每個訊息函式中所使用之資料流程的各個部分大小。
只有安全通道 安全性套件 才支援這個屬性。
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 結構的指標 。
這個值會傳回連線所支援之簽章類型的相關資訊。
只有安全通道 限制委派 才支援此值。
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 結構的指標 。
只有安全通道 限制委派 才支援此值。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。

 

pBuffer [out]

接收屬性之結構的指標。 指向的結構類型取決於 ulAttribute 參數中指定的 值。

傳回值

如果函式成功，則傳回值會SEC_E_OK。

如果函式失敗，傳回值是非零的錯誤碼。

備註

pBuffer 參數所 指向的結構會根據所查詢的屬性而有所不同。 呼叫端必須配置 pBuffer 結構本身，但 SSP 會配置任何保留 pBuffer 結構變數大小成員 所需的記憶體。 透過呼叫 FreeCoNtextBuffer 函式，即可釋放 SSP 配置的記憶體。

讀取SECPKG_ATTR_REMOTE_CERT_CONTEXT或SECPKG_ATTR_LOCAL_CERT_CONTEXT值之後， hCertStore 成員將會設定為包含中繼憑證的憑證存放區控制碼，如果有的話。 此外，應用程式會負責呼叫 CertFreeCertificateCoNtext 來釋放憑證內容所使用的記憶體。

需求

需求 值
最低支援的用戶端
 Windows XP [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限傳統型應用程式]
標題
Sspi.h （包括 Security.h）
程式庫
Secur32.lib
DLL
Secur32.dll
Unicode 和 ANSI 名稱
 QueryCoNtextAttributesW （Unicode） 和 QueryCoNtextAttributesA （ANSI）

另請參閱

SSPI 函式

支援服務中的驗證延伸保護 （EPA）

CERT_CONTEXT

FreeCoNtextBuffer

SecPkgCoNtext_Authority

SecPkgCoNtext_連線ionInfo

SecPkgCoNtext_DceInfo

SecPkgCoNtext_IssuerListInfoEx

SecPkgCoNtext_KeyInfo

SecPkgCoNtext_Lifespan

SecPkgCoNtext_Names

SecPkgCoNtext_Sizes

SecPkgCoNtext_StreamSizes