Share via

SpQueryContextAttributesFn-Rückruffunktion (ntsecpkg.h)

  • Artikel

Die SpQueryContextAttributes-Funktion ruft die Attribute eines Sicherheitskontexts ab.

Die SpQueryContextAttributes-Funktion ist die Dispatchfunktion für die Funktion QueryContextAttributes (General) der Schnittstelle für Sicherheitsunterstützungsanbieter.

Syntax

SpQueryContextAttributesFn Spquerycontextattributesfn;

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

Parameter

[in] ContextHandle

Ein Handle für den Sicherheitskontext.

[in] ContextAttribute

Zu abfragende Kontextattribute. Eine Liste der gültigen Werte finden Sie in der Funktion QueryContextAttributes (General).

[out] Buffer

Zeiger, der die Adresse eines Puffers empfängt, der die angeforderten Attribute enthält. Arbeitsspeicher für den Buffer-Parameter sollte der Funktion AllocateHeap aus der SECPKG_DLL_FUNCTIONS Funktionstabelle im Benutzermodus zugewiesen werden. Verwenden Sie im LSA-Modus ( Local Security Authority ) die Funktion AllocateLsaHeap .

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Code zurück, der den Grund für einen Fehler angibt. Im Folgenden werden ein häufiger Fehlergrund und der Fehlercode aufgeführt, den die Funktion zurückgeben soll.

Rückgabecode Beschreibung
SEC_E_INVALID_HANDLE
 Das Handle ist ungültig.

Hinweise

SSP/APs müssen die SpQueryContextAttributes-Funktion implementieren. Der tatsächliche Name, der der Implementierung zugewiesen wird, liegt jedoch beim Entwickler.

Ein Zeiger auf die Implementierung im LSA-Modus der SpQueryContextAttributes-Funktion ist in der SECPKG_FUNCTION_TABLE Struktur verfügbar, die von der SpLsaModeInitialize-Funktion empfangen wird.

Ein Zeiger auf die Benutzermodusimplementierung der SpQueryContextAttributes-Funktion ist in der SECPKG_USER_FUNCTION_TABLE Struktur verfügbar, die von der SpUserModeInitialize-Funktion empfangen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecpkg.h

Weitere Informationen

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize