SpQueryContextAttributesFn-Rückruffunktion (ntsecpkg.h)
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 |
|---|---|
|
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 |