Fungsi CredUnprotectA (wincred.h)

Artikel
11/20/2024

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

Sintaksis

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

[in] pszProtectedCredentials

Penunjuk ke string yang menentukan kredensial terenkripsi.

[in] cchProtectedCredentials

Ukuran, dalam karakter, dari pszProtectedCredentials buffer.

[out] pszCredentials

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

[in, out] pcchMaxChars

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

Mengembalikan nilai

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 ukurannya tidak mencukupi.

Komentar

Nota

Header wincred.h mendefinisikan CredUnprotect 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

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

Bagikan melalui