CredReadFn-Rückruffunktion (ntsecpkg.h)

Artikel
02/29/2024

Liest Anmeldeinformationen aus dem Anmeldeinformations-Manager.

Syntax

CredReadFn Credreadfn;

NTSTATUS Credreadfn(
  [in]  PLUID LogonId,
  [in]  ULONG CredFlags,
  [in]  LPWSTR TargetName,
  [in]  ULONG Type,
  [in]  ULONG Flags,
  [out] PENCRYPTED_CREDENTIALW *Credential
)
{...}

Parameter

[in] LogonId

Die Anmelde-ID, für die Anmeldeinformationen gelesen werden sollen.

[in] CredFlags

Flags, die das Verhalten dieser Funktion bestimmen. Die folgenden Flags werden definiert.

Wert	Bedeutung
CREDP_FLAGS_IN_PROCESS 0x01	Der Aufrufer ist in Bearbeitung.
CREDP_FLAGS_USE_MIDL_HEAP 0x02	Der Aufrufer sollte die midl_user_allocate-Funktion verwenden, um den Anmeldeinformationspuffer zuzuweisen.
CREDP_FLAGS_DONT_CACHE_TI 0x04	Zwischenspeichern Sie keine Zielinformationen.
CREDP_FLAGS_CLEAR_PASSWORD 0x08	Die Anmeldeinformationen werden als Klartext übergeben.
CREDP_FLAGS_USER_ENCRYPTED_PASSWORD 0x10	Die Anmeldeinformationen werden mithilfe der RtlEncryptMemory-Funktion verschlüsselt.
CREDP_FLAGS_TRUSTED_CALLER 0x20	Der Aufrufer ist ein vertrauenswürdiger Prozess.

[in] TargetName

Name des Zielcomputers.

[in] Type

Gibt den Typ der zu lesenden Anmeldeinformationen an. Die möglichen Werte für diesen Parameter sind mit den möglichen Werten des Type-Members der CREDENTIAL-Struktur identisch.

[in] Flags

Reserviert. Dieser Parameter muss auf 0 festgelegt werden.

[out] Credential

Ein Zeiger auf einen Zeiger auf eine ENCRYPTED_CREDENTIALW Struktur, die die Von dieser Funktion gelesenen Anmeldeinformationen empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS oder einen informationellen status Code zurück.

Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Fehlercode zurück, der den Grund für einen Fehler angibt.

Hinweise

Ein Zeiger auf die CrediRead-Funktion ist in der LSA_SECPKG_FUNCTION_TABLE Struktur verfügbar, die von der SpInitialize-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

SpInitialize

Freigeben über