QueryContextAttributes （Negotiate） 函式

QueryContextAttributes （Negotiate） 函式可讓傳輸應用程式查詢交涉安全性套件，以取得安全性內容的特定屬性。

語法

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_AUTHORITY 6	pBuffer 參數包含SecPkgContext_Authority結構的指標。 查詢驗證授權單位的名稱。
SECPKG_ATTR_CLIENT_SPECIFIED_TARGET 二十七	pBuffer 參數包含SecPkgContext_ClientSpecifiedTarget結構的指標，代表用戶端提供之初始目標的服務主體名稱 （SPN）。 只有在使用通道系結時，才支援此值。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。
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_FLAGS 14	pBuffer 參數包含SecPkgContext_Flags結構的指標。 傳回交涉內容旗標的相關信息。
SECPKG_ATTR_KEY_INFO 5	pBuffer 參數包含SecPkgContext_KeyInfo結構的指標。 查詢 安全性內容中使用的金鑰相關信息。
SECPKG_ATTR_LAST_CLIENT_TOKEN_STATUS 30	pBuffer 參數包含SecPkgContext_LastClientTokenStatus結構的指標，指定來自最近呼叫 InitializeSecurityContext 函式的令牌是否為客戶端的最後一個令牌。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此值。
SECPKG_ATTR_LIFESPAN 2	pBuffer 參數包含SecPkgContext_Lifespan結構的指標。 查詢內容生命週期。
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_ROOT_STORE 0x55	pBuffer 參數包含 HCERTCONTEXT 的指標。 尋找包含根存放區所提供之憑證的憑證內容。
SECPKG_ATTR_SESSION_KEY 9	pBuffer 參數包含SecPkgContext_SessionKey結構的指標。 傳回 會話金鑰的相關信息。
SECPKG_ATTR_SIZES 0	pBuffer 參數包含SecPkgContext_Sizes結構的指標。 查詢每個訊息函式中使用的結構大小。
SECPKG_ATTR_TARGET_INFORMATION 17	pBuffer 參數包含SecPkgContext_TargetInformation結構的指標。 傳回遠端伺服器名稱的相關信息。

 

pBuffer [out]

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

返回值

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

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

備註

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

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

需求

另請參閱

SSPI 函式

CERT_CONTEXT

FreeContextBuffer

SecPkgContext_Authority

SecPkgContext_ConnectionInfo

SecPkgContext_DceInfo

SecPkgContext_IssuerListInfoEx

SecPkgContext_KeyInfo

SecPkgContext_Lifespan

SecPkgContext_Names

SecPkgContext_Sizes

SecPkgContext_StreamSizes