Fungsi CredUnprotectA (wincred.h)

Artikel
03/08/2023

Fungsi CredUnprotect mendekripsi kredensial yang sebelumnya dienkripsi dengan menggunakan fungsi CredProtect . Kredensial harus dienkripsi dalam konteks keamanan yang sama di mana CredUnprotect dipanggil.

Sintaks

BOOL CredUnprotectA(
  [in]      BOOL  fAsSelf,
  [in]      LPSTR pszProtectedCredentials,
  [in]      DWORD cchProtectedCredentials,
  [out]     LPSTR pszCredentials,
  [in, out] DWORD *pcchMaxChars
);

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] pszProtectedCredentials

Penunjuk ke string yang menentukan kredensial terenkripsi.

[in] cchProtectedCredentials

Ukuran, dalam karakter, dari buffer pszProtectedCredentials .

[out] pszCredentials

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

[in, out] pcchMaxChars

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

Nilai kembali

TRUE jika fungsi berhasil; jika tidak, FALSE.

Untuk informasi kesalahan yang diperluas, panggil fungsi GetLastError . Tabel berikut ini memperlihatkan nilai umum untuk fungsi GetLastError .

Mengembalikan kode/nilai	Deskripsi
ERROR_NOT_CAPABLE	Konteks keamanan yang digunakan untuk mengenkripsi kredensial berbeda dari konteks keamanan yang digunakan untuk mendekripsi kredensial.
ERROR_INSUFFICIENT_BUFFER	Buffer pszCredentials berukuran tidak mencukuum.

Keterangan

Catatan

Header wincred.h mendefinisikan CredUnprotect sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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

Persyaratan	Nilai
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