struktur CERT_PHYSICAL_STORE_INFO (wincrypt.h)

Artikel
08/27/2023

Struktur CERT_PHYSICAL_STORE_INFO berisi informasi tentang penyimpanan sertifikat fisik. Beberapa anggota struktur ini diteruskan langsung ke panggilan sistem CertOpenStore untuk membuka toko fisik.

Sintaks

typedef struct _CERT_PHYSICAL_STORE_INFO {
  DWORD           cbSize;
  LPSTR           pszOpenStoreProvider;
  DWORD           dwOpenEncodingType;
  DWORD           dwOpenFlags;
  CRYPT_DATA_BLOB OpenParameters;
  DWORD           dwFlags;
  DWORD           dwPriority;
} CERT_PHYSICAL_STORE_INFO, *PCERT_PHYSICAL_STORE_INFO;

Anggota

cbSize

Ukuran, dalam byte, dari struktur ini.

pszOpenStoreProvider

Penunjuk ke string yang menamai jenis penyedia penyimpanan sertifikat . String ini diteruskan dalam panggilan sistem ke CertOpenStore dan menentukan jenis penyedia penyimpanan sertifikat yang akan dibuka. Untuk nama jenis penyimpanan sertifikat yang telah ditentukan sebelumnya, lihat CertOpenStore.

Selain jenis penyedia penyimpanan sertifikat yang telah ditentukan sebelumnya, jenis penyedia toko baru dapat diinstal dan didaftarkan dengan CryptInstallOIDFunctionAddress atau CryptRegisterOIDFunction. Untuk informasi selengkapnya, lihat CertOpenStore.

dwOpenEncodingType

Anggota ini hanya berlaku ketika CERT_STORE_PROV_MSG, CERT_STORE_PROV_PKCS7, atau CERT_STORE_PROV_FILENAME diteruskan di lpszStoreProvider. Jika tidak, anggota ini tidak digunakan.

Selalu dapat diterima untuk menentukan jenis pengodean sertifikat dan pesan dengan menggabungkannya dengan operasi bitwise-OR seperti yang ditunjukkan dalam contoh berikut:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Jenis pengodean yang ditentukan saat ini adalah:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

dwOpenFlags

Jika penyimpanan sistem dibuka dengan lokasi penyimpanan LAYANAN atau PENGGUNA, lokasi penyimpanan dwOpenFlags diatur ke CERT_SYSTEM_STORE_USERS atau CERT_SYSTEM_STORE_SERVICES.

OpenParameters

CRYPT_DATA_BLOB yang berisi data yang akan diteruskan ke parameter pvPara dari fungsi CertOpenStore. Jenis data tergantung pada penyedia yang ditentukan. Untuk informasi terperinci tentang jenis dan konten yang akan diteruskan, lihat deskripsi penyedia yang tersedia di CertOpenStore.

dwFlags

Nilai dwFlags berikut untuk CERT_PHYSICAL_STORE_INFO ditentukan.

Nilai	Makna
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG	Mengaktifkan penambahan konteks ke penyimpanan.
CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG	Diatur oleh fungsi CertRegisterPhysicalStore . Secara default, semua penyimpanan sistem yang terletak di registri memiliki penyimpanan fisik SystemRegistry implisit yang dibuka. Untuk menonaktifkan pembukaan toko ini, penyimpanan fisik SystemRegistry yang sesuai dengan penyimpanan Sistem harus didaftarkan dengan mengatur CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG atau dengan mendaftarkan penyimpanan fisik bernama ". Default" dengan CertRegisterPhysicalStore.
CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG	Menonaktifkan pembukaan jarak jauh penyimpanan fisik.
CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG	Places string \\ComputerName di depan jenis penyedia lainnya.
CERT_SYSTEM_STORE_RELOCATE_FLAG	Memungkinkan CertOpenStore untuk membuka penyimpanan relatif terhadap HKEY yang ditentukan pengguna, bukan salah satu konstanta HKEY yang telah ditentukan sebelumnya. Misalnya, HKEY_CURRENT_USER dapat diganti dengan HKEY yang ditentukan pengguna. Ketika CERT_SYSTEM_STORE_RELOCATE_FLAG diatur, parameter pvPara yang diteruskan ke CertOpenStore menunjuk ke struktur CERT_SYSTEM_STORE_RELOCATE_PARA alih-alih menunjuk ke nama penyimpanan sebagai untai (karakter) Unicode atau ASCII yang dihentikan null.

dwPriority

Ketika penyimpanan sistem dibuka, penyimpanan fisiknya dipesan sesuai dengan pengaturan dwPriority mereka. dwPriority yang lebih tinggi menunjukkan prioritas yang lebih tinggi. Anggota dwPriority diteruskan ke CertAddStoreToCollection.

Persyaratan

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

Lihat juga

CertAddStoreToCollection

CertOpenStore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction

Bagikan melalui