estructura CERT_PHYSICAL_STORE_INFO (wincrypt.h)

  • Artículo

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
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG
 Permite agregar un contexto al almacén.
CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG
 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.
CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG
 Deshabilita la apertura remota del almacén físico.
CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG
 Places la cadena \\ComputerName delante de otros tipos de proveedor.
CERT_SYSTEM_STORE_RELOCATE_FLAG
 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

Consulte también

CertAddStoreToCollection

CertOpenStore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction