structure CERT_PHYSICAL_STORE_INFO (wincrypt.h)

Article
03/03/2024

La structure CERT_PHYSICAL_STORE_INFO contient des informations sur les magasins de certificats physiques. Certains membres de ces structures sont passés directement aux appels système de CertOpenStore pour ouvrir le magasin physique.

Syntaxe

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;

Membres

cbSize

Taille, en octets, de cette structure.

pszOpenStoreProvider

Pointeur vers une chaîne qui nomme un type de fournisseur de magasin de certificats . Cette chaîne est passée dans un appel système à CertOpenStore et détermine le type de fournisseur d’un magasin de certificats à ouvrir. Pour obtenir les noms des types de magasins de certificats prédéfinis, consultez CertOpenStore.

Outre les types de fournisseurs de magasins de certificats prédéfinis, de nouveaux types de fournisseurs de magasin peuvent être installés et inscrits auprès de CryptInstallOIDFunctionAddress ou CryptRegisterOIDFunction. Pour plus d’informations, consultez CertOpenStore.

dwOpenEncodingType

Ce membre s’applique uniquement lorsque CERT_STORE_PROV_MSG, CERT_STORE_PROV_PKCS7 ou CERT_STORE_PROV_FILENAME est passé dans lpszStoreProvider. Sinon, ce membre n’est pas utilisé.

Il est toujours acceptable de spécifier les types d’encodage de certificat et de message en les combinant avec une opération OR au niveau du bit, comme illustré dans l’exemple suivant :

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING types d’encodage actuellement définis sont les suivants :

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

dwOpenFlags

Si un magasin système est ouvert avec l’emplacement du magasin SERVICES ou UTILISATEURS, l’emplacement du magasin dwOpenFlags est défini sur CERT_SYSTEM_STORE_USERS ou CERT_SYSTEM_STORE_SERVICES.

OpenParameters

Une CRYPT_DATA_BLOB qui contient les données à passer au paramètre pvPara de la fonction CertOpenStore . Le type de données dépend du fournisseur spécifié. Pour plus d’informations sur le type et le contenu à transmettre, consultez les descriptions des fournisseurs disponibles dans CertOpenStore.

dwFlags

Les valeurs dwFlags suivantes pour CERT_PHYSICAL_STORE_INFO sont définies.

Valeur	Signification
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG	Active l’ajout d’un contexte au magasin.
CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG	Défini par la fonction CertRegisterPhysicalStore . Par défaut, tous les magasins système situés dans le Registre ont un magasin physique SystemRegistry implicite qui est ouvert. Pour désactiver l’ouverture de ce magasin, le magasin physique SystemRegistry qui correspond au magasin système doit être inscrit en définissant CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG ou en inscrivant un magasin physique nommé ». Default » avec CertRegisterPhysicalStore.
CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG	Désactive l’ouverture à distance du magasin physique.
CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG	Places la chaîne \\ComputerName devant d’autres types de fournisseurs.
CERT_SYSTEM_STORE_RELOCATE_FLAG	Permet à CertOpenStore d’ouvrir un magasin par rapport à un HKEY spécifié par l’utilisateur au lieu d’une des constantes HKEY prédéfinies. Par exemple, HKEY_CURRENT_USER peut être remplacé par un HKEY spécifié par l’utilisateur. Lorsque CERT_SYSTEM_STORE_RELOCATE_FLAG est défini, le paramètre pvPara passé à CertOpenStore pointe vers une structure de CERT_SYSTEM_STORE_RELOCATE_PARA au lieu de pointer vers le nom du magasin en tant que chaîne Unicode ou ASCII terminée par null.

dwPriority

Lorsqu’un magasin système est ouvert, ses magasins physiques sont classés en fonction de leurs paramètres dwPriority . Un dwPriority plus élevé indique une priorité plus élevée. Le membre dwPriority est passé à CertAddStoreToCollection.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	wincrypt.h

Voir aussi

CertAddStoreToCollection

CertOpenStore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction

Share via