struktur CMSG_KEY_AGREE_RECIPIENT_ENCODE_INFO (wincrypt.h)

Artikel
08/27/2023

Struktur CMSG_KEY_AGREE_RECIPIENT_ENCODE_INFO berisi informasi tentang penerima pesan yang menggunakan manajemen kunci perjanjian kunci. Struktur ini digunakan dengan struktur CMSG_RECIPIENT_ENCODE_INFO .

Sintaks

typedef struct _CMSG_KEY_AGREE_RECIPIENT_ENCODE_INFO {
  DWORD                                     cbSize;
  CRYPT_ALGORITHM_IDENTIFIER                KeyEncryptionAlgorithm;
  void                                      *pvKeyEncryptionAuxInfo;
  CRYPT_ALGORITHM_IDENTIFIER                KeyWrapAlgorithm;
  void                                      *pvKeyWrapAuxInfo;
  HCRYPTPROV_LEGACY                         hCryptProv;
  DWORD                                     dwKeySpec;
  DWORD                                     dwKeyChoice;
  union {
    PCRYPT_ALGORITHM_IDENTIFIER pEphemeralAlgorithm;
    PCERT_ID                    pSenderId;
  } DUMMYUNIONNAME;
  CRYPT_DATA_BLOB                           UserKeyingMaterial;
  DWORD                                     cRecipientEncryptedKeys;
  PCMSG_RECIPIENT_ENCRYPTED_KEY_ENCODE_INFO *rgpRecipientEncryptedKeys;
} CMSG_KEY_AGREE_RECIPIENT_ENCODE_INFO, *PCMSG_KEY_AGREE_RECIPIENT_ENCODE_INFO;

Anggota

cbSize

Ukuran, dalam byte, dari struktur ini.

KeyEncryptionAlgorithm

Struktur CRYPT_ALGORITHM_IDENTIFIER yang menentukan algoritma yang digunakan untuk enkripsi.

Untuk penerima ECC, anggota pszObjId dari struktur CRYPT_ALGORITHM_IDENTIFIER harus diatur ke szOID_DH_SINGLE_PASS_STDDH_SHA1_KDF dengan anggota dwKeyChoice dari struktur CMSG_KEY_AGREE_RECIPIENT_ENCODE_INFO ini diatur ke CMSG_KEY_AGREE_EPHEMERAL_KEY_CHOICE.

pvKeyEncryptionAuxInfo

Anggota ini saat ini tidak digunakan. Ini harus diatur ke NULL.

KeyWrapAlgorithm

Struktur CRYPT_ALGORITHM_IDENTIFIER yang menentukan algoritma yang digunakan untuk pembungkusan kunci.

pvKeyWrapAuxInfo

Penunjuk ke struktur CMSG_RC2_AUX_INFO yang menentukan panjang bit pembungkusan kunci. Anggota ini hanya digunakan jika anggota KeyWrapAlgorithm menentukan algoritma RC2. Jika KeyWrapAlgorithm menentukan algoritma selain algoritma RC2, anggota ini tidak digunakan dan harus NULL.

hCryptProv

Anggota ini tidak digunakan dan harus diatur ke NULL.

Windows Server 2003 dan Windows XP: Handel ke penyedia layanan kriptografi (CSP) yang diperoleh dengan menggunakan fungsi CryptAcquireContext . Anggota ini bersifat opsional dan dapat berupa NULL. Jenis data anggota ini adalah HCRYPTPROV.

dwKeySpec

Anggota ini saat ini tidak digunakan.

dwKeyChoice

Menunjukkan jenis perjanjian kunci. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CMSG_KEY_AGREE_EPHEMERAL_KEY_CHOICE	Buat pasangan kunci publik/privat sementara untuk mengenkripsi kunci enkripsi konten.
CMSG_KEY_AGREE_STATIC_KEY_CHOICE	Nilai ini saat ini tidak digunakan.

DUMMYUNIONNAME

DUMMYUNIONNAME.pEphemeralAlgorithm

Penunjuk ke struktur CRYPT_ALGORITHM_IDENTIFIER yang berisi algoritma dan parameter kunci publik ephemeral. Anggota ini digunakan ketika anggota dwKeyChoice berisi CMSG_KEY_AGREE_EPHEMERAL_KEY_CHOICE.

DUMMYUNIONNAME.pSenderId

Penunjuk ke struktur CERT_ID . Anggota ini digunakan ketika anggota dwKeyChoice berisi CMSG_KEY_AGREE_STATIC_KEY_CHOICE. Anggota ini saat ini tidak digunakan.

UserKeyingMaterial

Struktur CRYPT_DATA_BLOB yang berisi materi kunci pengguna (UKM) yang disediakan oleh pengirim untuk memastikan bahwa kunci yang berbeda dihasilkan setiap kali dua pihak yang sama menghasilkan kunci yang bijaksana. Anggota ini bersifat opsional dan semua anggota harus diatur ke nol jika tidak digunakan.

cRecipientEncryptedKeys

Jumlah elemen dalam array rgpRecipientEncryptedKeys .

rgpRecipientEncryptedKeys

Array struktur CMSG_RECIPIENT_ENCRYPTED_KEY_ENCODE_INFO , satu untuk setiap penerima untuk menerima kunci perjanjian kunci ini. Anggota cRecipientEncryptedKeys berisi jumlah elemen dalam struktur ini.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	wincrypt.h