Baca dalam bahasa Inggris

Bagikan melalui

Fungsi CryptCATPutAttrInfo (mscat.h)

  • Artikel

[Fungsi CryptCATPutAttrInfo tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Fungsi CryptCATPutAttrInfo mengalokasikan memori untuk atribut dan menambahkannya ke anggota katalog.

Sintaks

CRYPTCATATTRIBUTE * CryptCATPutAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag,
  [in] DWORD          dwAttrTypeAndAction,
  [in] DWORD          cbData,
  [in] BYTE           *pbData
);

Parameter

[in] hCatalog

Handel ke katalog yang diperoleh dari fungsi CryptCATOpen atau CryptCATHandleFromStore .

[in] pCatMember

Penunjuk ke struktur CRYPTCATMEMBER yang berisi anggota katalog.

[in] pwszReferenceTag

Penunjuk ke string yang dihentikan null yang berisi nama atribut.

[in] dwAttrTypeAndAction

Nilai yang mewakili kombinasi bitwise dari bendera berikut. Pemanggil setidaknya harus menentukan CRYPTCAT_ATTR_DATABASE64 atau CRYPTCAT_ATTR_DATAASCII.

Nilai Makna
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 Atribut diautentikasi.
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 Atribut tidak diaauthenticated.
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 Atribut adalah string ASCII.
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 Atribut adalah pengidentifikasi objek kriptografi (OID).
CRYPTCAT_ATTR_DATAASCII
0x00010000
 Atribut berisi karakter ASCII sederhana yang tidak boleh didekodekan.
CRYPTCAT_ATTR_DATABASE64
0x00020000
 Atribut dalam format base 64.
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 Atribut menggantikan nilai untuk atribut yang ada.

[in] cbData

Nilai yang menentukan jumlah byte dalam buffer pbData .

[in] pbData

Penunjuk ke buffer memori yang berisi nilai atribut.

Nilai kembali

Setelah berhasil, fungsi ini mengembalikan pointer ke struktur CRYPTCATATTRIBUTE yang berisi atribut yang ditetapkan. Penelepon tidak boleh membebaskan pointer ini atau anggotanya.

Jika fungsi ini mengembalikan NULL, informasi kesalahan tambahan dapat diperoleh dengan memanggil fungsi GetLastError . GetLastError akan mengembalikan salah satu kode kesalahan berikut.

Menampilkan kode Deskripsi
ERROR_INVALID_PARAMETER
 Satu atau beberapa parameter tidak valid.
ERROR_NOT_ENOUGH_MEMORY
 Sistem operasi kehabisan memori selama operasi.

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 mscat.h
Pustaka Wintrust.lib
DLL Wintrust.dll