estructura CERT_PHYSICAL_STORE_INFO (wincrypt.h)
La estructura CERT_PHYSICAL_STORE_INFO contiene información sobre los almacenes de certificados físicos. Algunos miembros de estas estructuras se pasan directamente a las llamadas del sistema de CertOpenStore para abrir el almacén físico.
Sintaxis
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;
Miembros
cbSize
Tamaño, en bytes, de esta estructura.
pszOpenStoreProvider
Puntero a una cadena que asigna un nombre a un tipo de proveedor de almacén de certificados . Esta cadena se pasa en una llamada del sistema a CertOpenStore y determina el tipo de proveedor de un almacén de certificados que se va a abrir. Para conocer los nombres de los tipos de almacén de certificados predefinidos, consulte CertOpenStore.
Además de los tipos de proveedor de almacén de certificados predefinidos, se pueden instalar y registrar nuevos tipos de proveedor de almacén con CryptInstallOIDFunctionAddress o CryptRegisterOIDFunction. Para obtener más información, vea CertOpenStore.
dwOpenEncodingType
Este miembro solo se aplica cuando se pasan CERT_STORE_PROV_MSG, CERT_STORE_PROV_PKCS7 o CERT_STORE_PROV_FILENAME en lpszStoreProvider. De lo contrario, este miembro no se usa.
Siempre es aceptable especificar los tipos de codificación de certificados y mensajes al combinarlos con una operación OR bit a bit, como se muestra en el ejemplo siguiente:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING tipos de codificación definidos actualmente son:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
dwOpenFlags
Si se abre un almacén del sistema con la ubicación del almacén SERVICIOS o USUARIOS, la ubicación del almacén dwOpenFlags se establece en CERT_SYSTEM_STORE_USERS o CERT_SYSTEM_STORE_SERVICES.
OpenParameters
Un CRYPT_DATA_BLOB que contiene datos que se van a pasar al parámetro pvPara de la función CertOpenStore . El tipo de datos depende del proveedor especificado. Para obtener información detallada sobre el tipo y el contenido que se van a pasar, consulte descripciones de proveedores disponibles en CertOpenStore.
dwFlags
Se definen los siguientes valores dwFlags para CERT_PHYSICAL_STORE_INFO.
Valor | Significado |
---|---|
|
Permite agregar un contexto al almacén. |
|
Establezca por la función CertRegisterPhysicalStore . De forma predeterminada, todos los almacenes del sistema ubicados en el registro tienen un almacén físico SystemRegistry implícito que se abre. Para deshabilitar la apertura de este almacén, el almacén físico SystemRegistry que corresponde al almacén del sistema debe registrarse estableciendo CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG o registrando un almacén físico denominado ". Default" con CertRegisterPhysicalStore. |
|
Deshabilita la apertura remota del almacén físico. |
|
Places la cadena \\ComputerName delante de otros tipos de proveedor. |
|
Habilita CertOpenStore para abrir un almacén en relación con un HKEY especificado por el usuario en lugar de una de las constantes HKEY predefinidas. Por ejemplo, HKEY_CURRENT_USER se puede reemplazar por un HKEY especificado por el usuario. Cuando se establece CERT_SYSTEM_STORE_RELOCATE_FLAG, el parámetro pvPara pasado a CertOpenStore apunta a una estructura de CERT_SYSTEM_STORE_RELOCATE_PARA en lugar de apuntar al nombre del almacén como una cadena Unicode o ASCII terminada en null. |
dwPriority
Cuando se abre un almacén del sistema, sus almacenes físicos se ordenan según su configuración dwPriority . Una dwPriority mayor indica una prioridad más alta. El miembro dwPriority se pasa a CertAddStoreToCollection.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Encabezado | wincrypt.h |