Fungsi WintrustGetDefaultForUsage (wintrust.h)

  • Artikel

Fungsi WintrustGetDefaultForUsage mengambil pengidentifikasi penggunaan default dan informasi panggilan balik.

Sintaks

BOOL WintrustGetDefaultForUsage(
  [in]      DWORD                   dwAction,
  [in]      const char              *pszUsageOID,
  [in, out] CRYPT_PROVIDER_DEFUSAGE *psUsage
);

Parameter

[in] dwAction

Tindakan yang harus dilakukan. Ini bisa menjadi salah satu nilai berikut. Untuk informasi selengkapnya, lihat Keterangan.

Nilai Makna
DWACTION_ALLOCANDFILL
 Alokasikan memori dan isi struktur CRYPT_PROVIDER_DEFUSAGE yang diarahkan oleh parameter psUsage .
DWACTION_FREE
 Bebaskan semua memori yang dialokasikan selama panggilan sebelumnya ke fungsi ini dengan menentukan DWACTION_ALLOCANDFILL untuk parameter ini.

[in] pszUsageOID

Penunjuk ke string yang berisi pengidentifikasi.

[in, out] psUsage

Penunjuk ke struktur CRYPT_PROVIDER_DEFUSAGE yang berisi informasi panggilan balik yang akan diambil.

Mengembalikan nilai

Nilai yang dikembalikan adalah TRUE jika fungsi berhasil; FALSE jika fungsi gagal. Jika fungsi gagal, panggil fungsi GetLastError untuk menentukan alasan kegagalan.

Keterangan

Panggil fungsi ini sekali dengan parameter dwAction diatur ke DWACTION_ALLOCANDFILL untuk mengalokasikan memori dan mengisi struktur CRYPT_PROVIDER_DEFUSAGE dengan informasi. Panggil fungsi ini lagi dengan parameter dwAction diatur ke DWACTION_FREE untuk membebaskan memori yang dialokasikan.

Informasi penggunaan dan panggilan balik default untuk penyedia didaftarkan dengan memanggil fungsi WintrustAddDefaultForUsage .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header wintrust.h
Pustaka Wintrust.lib
DLL Wintrust.dll

Lihat juga

CRYPT_PROVIDER_DEFUSAGE

CRYPT_PROVIDER_REGDEFUSAGE

WintrustAddDefaultForUsage