CredProtectW-Funktion (wincred.h)

Artikel
11/20/2024

Die CredProtect--Funktion verschlüsselt die angegebenen Anmeldeinformationen, sodass nur der aktuelle Sicherheitskontext sie entschlüsseln kann.

Syntax

BOOL CredProtectW(
  [in]      BOOL                 fAsSelf,
  [in]      LPWSTR               pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPWSTR               pszProtectedCredentials,
  [in, out] DWORD                *pcchMaxChars,
  [out]     CRED_PROTECTION_TYPE *ProtectionType
);

Parameter

[in] fAsSelf

Legen Sie auf TRUE fest,, um anzugeben, dass die Anmeldeinformationen im Sicherheitskontext des aktuellen Prozesses verschlüsselt sind. Legen Sie auf FALSE- fest, um anzugeben, dass Anmeldeinformationen im Sicherheitskontext des aufrufenden Threadsicherheitskontexts verschlüsselt sind.

[in] pszCredentials

Ein Zeiger auf eine Zeichenfolge, die die zu verschlüsselnden Anmeldeinformationen angibt. Die Funktion verschlüsselt die Anzahl der Zeichen, die im cchCredentials Parameter angegeben werden.

[in] cchCredentials

Die Größe des pszCredentials- Puffers in Zeichen.

[out] pszProtectedCredentials

Ein Zeiger auf eine Zeichenfolge, die bei der Ausgabe die verschlüsselten Anmeldeinformationen empfängt.

[in, out] pcchMaxChars

Die Größe in Zeichen des pszProtectedCredentials- Puffers. Wenn die pszProtectedCredentials- nicht ausreichend groß ist, um die verschlüsselten Anmeldeinformationen zu empfangen, gibt dieser Parameter die erforderliche Größe des pszProtectedCredentials Puffers in Zeichen an.

[out] ProtectionType

Ein Zeiger auf einen CRED_PROTECTION_TYPE Enumerationstyp, der bei der Ausgabe den bereitgestellten Schutztyp angibt.

Rückgabewert

TRUE, wenn die Funktion erfolgreich ist; andernfalls FALSE.

Rufen Sie für erweiterte Fehlerinformationen die GetLastError--Funktion auf.

Bemerkungen

Beachten Sie, dass die Ausgabe der CredProtect--Funktion nicht integritätssicher ist. Wenn die Ausgabe geändert wird, wird die CredUnprotect-Funktion nicht aktualisiert und kann zu falschen Ergebnissen führen.

Anmerkung

Der wincred.h-Header definiert CredProtect als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wincred.h
Library	Advapi32.lib
DLL-	Advapi32.dll

Freigeben über