SpQueryCredentialsAttributesFn 回呼函式 (ntsecpkg.h)

  • 發行項

SpQueryCredentialsAttributes 函式會擷取認證的屬性。

SpQueryCredentialsAttributes 函式是安全性支援提供者介面之 QueryCredentialsAttributes 函式的分派函式。

語法

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

參數

[in] CredentialHandle

要查詢之認證的句柄。

[in] CredentialAttribute

要查詢的屬性。 下表列出有效的值。

值 意義
SECPKG_CRED_ATTR_NAMES
 與 認證相關聯的主體名稱。
SECPKG_ATTR_SUPPORTED_ALGS
 特定認證支持的演算法。
SECPKG_ATTR_CIPHER_STRENGTHS
 與認證搭配使用的最小和最大加密強度。
SECPKG_ATTR_SUPPORTED_PROTOCOLS
 特定認證支持的通訊協定。

[out] Buffer

接收所要求屬性之緩衝區的指標。 使用 AllocateClientBuffer 函式配置此緩衝區的記憶體，讓呼叫端可以呼叫 FreeContextBuffer 函式來釋放它。

傳回值

如果函式成功，則傳回STATUS_SUCCESS。

如果函式失敗，則傳回 NTSTATUS 程式代碼，指出失敗的原因。 下列列出失敗的常見原因，以及函式應該傳回的錯誤碼。

傳回碼 Description
SEC_E_INSUFFICIENT_MEMORY
 記憶體配置失敗。
SEC_E_INVALID_HANDLE
 認證句柄無效。

備註

SSP/AP 必須實作 SpQueryCredentialsAttributes 函式;不過，提供給實作的實際名稱會由開發人員決定。

SpQueryCredentialsAttributes 函式的指標可在從 SpLsaModeInitialize 函式接收的 SECPKG_FUNCTION_TABLE 結構中使用。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 ntsecpkg.h

另請參閱

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize