CredUnprotectA-Funktion (wincred.h)

Artikel
03/13/2024

Die CredUnprotect-Funktion entschlüsselt Anmeldeinformationen, die zuvor mit der Funktion CredProtect verschlüsselt wurden. Die Anmeldeinformationen müssen im gleichen Sicherheitskontext verschlüsselt worden sein, in dem CredUnprotect aufgerufen wird.

Syntax

BOOL CredUnprotectA(
  [in]      BOOL  fAsSelf,
  [in]      LPSTR pszProtectedCredentials,
  [in]      DWORD cchProtectedCredentials,
  [out]     LPSTR pszCredentials,
  [in, out] DWORD *pcchMaxChars
);

Parameter

[in] fAsSelf

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

[in] pszProtectedCredentials

Ein Zeiger auf eine Zeichenfolge, die die verschlüsselten Anmeldeinformationen angibt.

[in] cchProtectedCredentials

Die Größe des Puffers pszProtectedCredentials in Zeichen.

[out] pszCredentials

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

[in, out] pcchMaxChars

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

Rückgabewert

TRUE , wenn die Funktion erfolgreich ist; andernfalls FALSE.

Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten. Die folgende Tabelle enthält allgemeine Werte für die GetLastError-Funktion .

Rückgabecode/-wert	BESCHREIBUNG
ERROR_NOT_CAPABLE	Der Sicherheitskontext, der zum Verschlüsseln der Anmeldeinformationen verwendet wird, unterscheidet sich von dem Sicherheitskontext, der zum Entschlüsseln der Anmeldeinformationen verwendet wird.
ERROR_INSUFFICIENT_BUFFER	Der Puffer pszCredentials war nicht ausreichend groß.

Hinweise

Hinweis

Der wincred.h-Header definiert CredUnprotect als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincred.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Freigeben über