共用方式為

spQueryContextAttributesFn 回呼函式 (ntsecpkg.h)

  • 發行項

SpQueryContextAttributes 函式會擷取安全性內容的屬性。

SpQueryContextAttributes 函式是 Security Support Provider Interface 之 QueryContextAttributes (General) 函式的分派函式。

語法

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

參數

[in] ContextHandle

安全性內容的句柄。

[in] ContextAttribute

要查詢的內容屬性。 如需有效值的清單，請參閱 QueryContextAttributes (General) 函式。

[out] Buffer

接收包含所要求屬性之緩衝區位址的指標。 Buffer 參數的記憶體應該以使用者模式中的 SECPKG_DLL_FUNCTIONS 函式數據表中的 AllocateHeap 函式來配置。 在 [本機安全性授權單位 ] (LSA) 模式中，使用 AllocateLsaHeap 函式。

傳回值

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

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

傳回碼 Description
SEC_E_INVALID_HANDLE
 句柄無效。

備註

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

SpQueryContextAttributes 函式之 LSA 模式實作的指標可在從 SpLsaModeInitialize 函式收到的SECPKG_FUNCTION_TABLE結構中使用。

SpQueryContextAttributes 函式的使用者模式實作指標可在從 SpUserModeInitialize 函式收到的SECPKG_USER_FUNCTION_TABLE結構中使用。

規格需求

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

另請參閱

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize