CredProtectA-Funktion (wincred.h)

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

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 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.

Anforderungen