CredProtectA-Funktion (wincred.h)

  • Artikel

Die CredProtect-Funktion verschlüsselt die angegebenen Anmeldeinformationen, sodass sie nur vom aktuellen Sicherheitskontext entschlüsselt werden können.

Syntax

BOOL CredProtectA(
  [in]      BOOL                 fAsSelf,
  [in]      LPSTR                pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPSTR                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 werden. Legen Sie auf FALSE fest, um anzugeben, dass Anmeldeinformationen im Sicherheitskontext des aufrufenden Threads verschlüsselt werden.

[in] pszCredentials

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

[in] cchCredentials

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

[out] ProtectionType

Ein Zeiger auf einen CRED_PROTECTION_TYPE Enumerationstyp, der bei der Ausgabe den Typ des bereitgestellten Schutzes angibt.

Rückgabewert

TRUE , wenn die Funktion erfolgreich ist; andernfalls FALSE.

Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Beachten Sie, dass die Ausgabe der CredProtect-Funktion nicht integritätsschutzt ist. Wenn die Ausgabe geändert wird, wird die CredUnprotect-Funktion nicht aktualisiert und erzeugt möglicherweise falsche Ergebnisse.

Hinweis

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

   
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