CredUnprotectA-Funktion (wincred.h)

Artikel
11/20/2024

Die CredUnprotect-Funktion entschlüsselt Anmeldeinformationen, die zuvor mithilfe 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

Auf TRUE- festgelegt, 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 pszProtectedCredentials- Puffers 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 pszCredentials- Puffers. Wenn die pszCredentials- nicht ausreichend groß ist, um die verschlüsselten Anmeldeinformationen zu empfangen, gibt dieser Parameter die erforderliche Größe des pszCredentials Puffers an.

Rückgabewert

TRUE, wenn die Funktion erfolgreich ist; andernfalls FALSE.

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

Zurückgeben von Code/Wert	Beschreibung
ERROR_NOT_CAPABLE	Der Zum Verschlüsseln der Anmeldeinformationen verwendete Sicherheitskontext unterscheidet sich vom Sicherheitskontext, der zum Entschlüsseln der Anmeldeinformationen verwendet wird.
ERROR_INSUFFICIENT_BUFFER	Der pszCredentials- Puffer war nicht ausreichend groß.

Bemerkungen

Anmerkung

Der wincred.h-Header definiert CredUnprotect 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