Fungsi CredProtectA (wincred.h)

Fungsi CredProtect mengenkripsi kredensial yang ditentukan sehingga hanya konteks keamanan saat ini yang dapat mendekripsinya.

Sintaksis

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

Atur ke TRUE untuk menentukan bahwa kredensial dienkripsi dalam konteks keamanan proses saat ini. Atur ke FALSE untuk menentukan bahwa kredensial dienkripsi dalam konteks keamanan alur panggilan.

[in] pszCredentials

Penunjuk ke string yang menentukan kredensial untuk dienkripsi. Fungsi ini mengenkripsi jumlah karakter yang disediakan dalam parameter cchCredentials .

[in] cchCredentials

Ukurannya, dalam karakter, dari pszCredentials buffer.

[out] pszProtectedCredentials

Penunjuk ke string yang, pada output, menerima kredensial terenkripsi.

[in, out] pcchMaxChars

Ukurannya, dalam karakter pszProtectedCredentials buffer. Pada output, jika pszProtectedCredentials tidak cukup untuk menerima kredensial terenkripsi, parameter ini menentukan ukuran yang diperlukan, dalam karakter, dari pszProtectedCredentials buffer.

[out] ProtectionType

Penunjuk ke jenis enumerasi CRED_PROTECTION_TYPE yang, pada output, menentukan jenis perlindungan yang disediakan.

Mengembalikan nilai

TRUE jika fungsi berhasil; jika tidak, FALSE.

Untuk informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Komentar

Perhatikan bahwa output fungsi CredProtect tidak dilindungi integritas, jadi jika output dimodifikasi, fungsi CredUnprotect tidak diperbarui dan dapat menghasilkan hasil yang salah.

Persyaratan