Fungsi CryptSetProviderExA (wincrypt.h)

  • Artikel
Penting 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 CryptSetProviderEx menentukan penyedia layanan kriptografi default (CSP) dari jenis penyedia tertentu untuk komputer lokal atau pengguna saat ini.
Catatan Aplikasi umum tidak menggunakan fungsi ini. Ini dimaksudkan untuk digunakan hanya oleh aplikasi administratif.
 

Sintaks

BOOL CryptSetProviderExA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType,
  [in] DWORD  *pdwReserved,
  [in] DWORD  dwFlags
);

Parameter

[in] pszProvName

Nama CSP default baru. Ini harus berupa CSP yang terinstal pada komputer. Untuk daftar penyedia kriptografi yang tersedia, lihat Nama Penyedia Kriptografi.

[in] dwProvType

Jenis penyedia CSP yang ditentukan oleh pszProvName.

[in] pdwReserved

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus NULL.

[in] dwFlags

Nilai bendera berikut ditentukan.

Nilai Makna
CRYPT_DELETE_DEFAULT
0x00000004
 Dapat digunakan bersama dengan CRYPT_MACHINE_DEFAULT atau CRYPT_USER_DEFAULT untuk menghapus default.
CRYPT_USER_DEFAULT
0x00000002
 Menyebabkan CSP default konteks pengguna dari jenis yang ditentukan diatur.
CRYPT_MACHINE_DEFAULT
0x00000001
 Menyebabkan CSP default komputer dari jenis yang ditentukan diatur.

Nilai kembali

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

Jika fungsi gagal, nilai yang dikembalikan adalah nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Kemungkinan kode kesalahan menyertakan yang diperlihatkan dalam tabel berikut.

Menampilkan kode Deskripsi
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.

Keterangan

Sebagian besar aplikasi tidak menentukan nama CSP saat memanggil fungsi CryptAcquireContext ; namun, aplikasi dapat menentukan nama CSP dan dengan demikian memilih CSP dengan tingkat keamanan yang sesuai. Karena panggilan ke CryptSetProviderEx menentukan CSP dari jenis tertentu yang digunakan oleh semua aplikasi sejak saat itu, CryptSetProviderEx tidak boleh dipanggil tanpa persetujuan pengguna.

Catatan

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

Lihat juga

CryptAcquireContext

CryptSetProvider

Fungsi Penyedia Layanan