SpQueryCredentialsAttributesFn-Rückruffunktion (ntsecpkg.h)
Die SpQueryCredentialsAttributes-Funktion ruft die Attribute für anmeldeinformationen ab.
Die SpQueryCredentialsAttributes-Funktion ist die Dispatchfunktion für die QueryCredentialsAttributes-Funktion der Security Support Provider Interface.
Syntax
SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;
NTSTATUS Spquerycredentialsattributesfn(
[in] LSA_SEC_HANDLE CredentialHandle,
[in] ULONG CredentialAttribute,
[out] PVOID Buffer
)
{...}
Parameter
[in] CredentialHandle
Ein Handle für die abzufragenden Anmeldeinformationen.
[in] CredentialAttribute
Attribut für abfrage. In der folgenden Tabelle sind die gültigen Werte aufgeführt.
Wert | Bedeutung |
---|---|
|
Der Name des Prinzipals, der den Anmeldeinformationen zugeordnet ist. |
|
Die Algorithmen, die mit bestimmten Anmeldeinformationen unterstützt werden. |
|
Die minimale und maximale Verschlüsselungsstärke, die mit Anmeldeinformationen verwendet wird. |
|
Die Protokolle, die mit bestimmten Anmeldeinformationen unterstützt werden. |
[out] Buffer
Zeiger auf einen Puffer, der die angeforderten Attribute empfängt. Weisen Sie arbeitsspeicher für diesen Puffer mithilfe der AllocateClientBuffer-Funktion zu, damit der Aufrufer ihn durch Aufrufen der FreeContextBuffer-Funktion freigeben kann.
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 den Fehler angibt. Im Folgenden werden häufige Fehlerursachen und die Fehlercodes aufgeführt, die die Funktion zurückgeben soll.
Rückgabecode | Beschreibung |
---|---|
|
Die Speicherbelegung hat einen Fehler erzeugt. |
|
Das Handle für Anmeldeinformationen ist ungültig. |
Hinweise
SSP/APs müssen die SpQueryCredentialsAttributes-Funktion implementieren. Der tatsächliche Name, der der Implementierung gegeben wird, liegt jedoch beim Entwickler.
Ein Zeiger auf die SpQueryCredentialsAttributes-Funktion ist in der SECPKG_FUNCTION_TABLE-Struktur verfügbar, die von der SpLsaModeInitialize-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 |