Fungsi CertGetValidUsages (wincrypt.h)

Fungsi CertGetValidUsages mengembalikan array penggunaan yang terdiri dari persimpangan penggunaan yang valid untuk semua sertifikat dalam array sertifikat.

Sintaks

BOOL CertGetValidUsages(
  [in]      DWORD          cCerts,
  [in]      PCCERT_CONTEXT *rghCerts,
  [out]     int            *cNumOIDs,
  [out]     LPSTR          *rghOIDs,
  [in, out] DWORD          *pcbOIDs
);

Parameter

[in] cCerts

Jumlah sertifikat dalam array yang akan diperiksa.

[in] rghCerts

Array sertifikat yang akan diperiksa untuk penggunaan yang valid.

[out] cNumOIDs

Jumlah penggunaan valid yang ditemukan sebagai persimpangan penggunaan yang valid dari semua sertifikat dalam array. Jika semua sertifikat valid untuk semua penggunaan, cNumOID diatur ke negatif satu (–1).

[out] rghOIDs

Array pengidentifikasi objek (OID) dari penggunaan valid yang dibagikan oleh semua sertifikat dalam array rghCerts . Parameter ini dapat berupa NULL untuk mengatur ukuran struktur ini untuk tujuan alokasi memori. Untuk informasi selengkapnya, lihat Mengambil Data Dengan Panjang Tidak Diketahui.

[in, out] pcbOIDs

Penunjuk ke nilai DWORD yang menentukan ukuran, dalam byte, dari array rghOID dan string yang ditujukkan. Saat fungsi kembali, nilai DWORD berisi jumlah byte yang diperlukan untuk array.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol. Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll