Partager via


structure CERT_PHYSICAL_STORE_INFO (wincrypt.h)

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