Share via

SpQueryCredentialsAttributesFn-Rückruffunktion (ntsecpkg.h)

  • Artikel

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
SECPKG_CRED_ATTR_NAMES
 Der Name des Prinzipals, der den Anmeldeinformationen zugeordnet ist.
SECPKG_ATTR_SUPPORTED_ALGS
 Die Algorithmen, die mit bestimmten Anmeldeinformationen unterstützt werden.
SECPKG_ATTR_CIPHER_STRENGTHS
 Die minimale und maximale Verschlüsselungsstärke, die mit Anmeldeinformationen verwendet wird.
SECPKG_ATTR_SUPPORTED_PROTOCOLS
 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
SEC_E_INSUFFICIENT_MEMORY
 Die Speicherbelegung hat einen Fehler erzeugt.
SEC_E_INVALID_HANDLE
 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

Weitere Informationen

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize