Fungsi CredProtectA (wincred.h)

Artikel
03/08/2023

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

Sintaks

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 info masuk dienkripsi dalam konteks keamanan konteks keamanan utas panggilan.

[in] pszCredentials

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

[in] cchCredentials

Ukuran, dalam karakter, dari buffer pszCredentials .

[out] pszProtectedCredentials

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

[in, out] pcchMaxChars

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

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

Keterangan

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

Catatan

Header wincred.h mendefinisikan CredProtect sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wincred.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Bagikan melalui