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 |
|---|---|
|
Active l’ajout d’un contexte au magasin. |
|
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. |
|
Désactive l’ouverture à distance du magasin physique. |
|
Places la chaîne \\ComputerName devant d’autres types de fournisseurs. |
|
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 |