CredProtectA-Funktion (wincred.h)
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 |