Fungsi CryptSetProviderA (wincrypt.h)

Important API ini tidak digunakan lagi. Perangkat lunak baru dan yang sudah ada harus mulai menggunakan Cryptography Next Generation API. Microsoft dapat menghapus API ini dalam rilis mendatang.

 

Fungsi CryptSetProvider menentukan penyedia layanan kriptografi (CSP) default pengguna saat ini.

Jika penyedia default pengguna saat ini diatur, penyedia default tersebut diperoleh oleh panggilan apa pun oleh pengguna tersebut untuk CryptAcquireContext menentukan dwProvType jenis penyedia tetapi bukan nama CSP.

Versi yang disempurnakan dari fungsi ini, CryptSetProviderEx, juga tersedia.

Catatan Aplikasi umum tidak menggunakan fungsi ini. Ini ditujukan untuk digunakan hanya oleh aplikasi administratif.

 

Sintaksis

BOOL CryptSetProviderA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType
);

Parameter

[in] pszProvName

Nama CSP default baru. CSP bernama harus diinstal pada komputer. Untuk daftar penyedia kriptografi yang tersedia, lihat Nama Penyedia Kriptografi.

[in] dwProvType

Jenis penyedia CSP yang ditentukan oleh pszProvName.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol (TRUE).

Jika fungsi gagal, nilai yang dikembalikan adalah nol (FALSE). Untuk informasi kesalahan yang diperluas, panggil GetLastError. Beberapa kemungkinan kode kesalahan tercantum dalam tabel berikut.

Mengembalikan kode	Deskripsi
ERROR_INVALID_HANDLE	Salah satu parameter menentukan handel yang tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameter berisi nilai yang tidak valid. Ini paling sering merupakan pointer yang tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Sistem operasi kehabisan memori selama operasi.

 

Kesalahan juga dapat disebarluaskan dari panggilan internal ke RegCreateKeyEx dan RegSetValueEx.

Komentar

Aplikasi umum tidak menentukan nama CSP saat memanggil CryptAcquireContext; namun, aplikasi memang memiliki opsi untuk memilih CSP tertentu. Ini memberi pengguna kebebasan untuk memilih CSP dengan tingkat keamanan yang sesuai.

Karena memanggil CryptSetProvider menentukan CSP dari jenis tertentu yang digunakan oleh semua aplikasi yang berjalan sejak saat itu, fungsi ini tidak boleh dipanggil tanpa persetujuan pengguna.

Nota

Header wincrypt.h mendefinisikan CryptSetProvider sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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 XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	wincrypt.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

CryptAcquireContext

Nama Penyedia Kriptografi

RegCreateKeyEx

RegSetValueEx

Fungsi Penyedia Layanan