estrutura CERT_PHYSICAL_STORE_INFO (wincrypt.h)
A estrutura CERT_PHYSICAL_STORE_INFO contém informações sobre repositórios de certificados físicos. Alguns membros dessas estruturas são passados diretamente para chamadas do sistema do CertOpenStore para abrir o repositório físico.
Sintaxe
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;
Membros
cbSize
O tamanho, em bytes, dessa estrutura.
pszOpenStoreProvider
Um ponteiro para uma cadeia de caracteres que nomeia um tipo de provedor de repositório de certificados . Essa cadeia de caracteres é passada em uma chamada do sistema para CertOpenStore e determina o tipo de provedor de um repositório de certificados a ser aberto. Para obter os nomes dos tipos de repositório de certificados predefinidos, consulte CertOpenStore.
Além dos tipos de provedor de repositório de certificados predefinidos, novos tipos de provedor de repositório podem ser instalados e registrados com CryptInstallOIDFunctionAddress ou CryptRegisterOIDFunction. Para obter mais informações, consulte CertOpenStore.
dwOpenEncodingType
Esse membro é aplicável somente quando CERT_STORE_PROV_MSG, CERT_STORE_PROV_PKCS7 ou CERT_STORE_PROV_FILENAME é passado em lpszStoreProvider. Caso contrário, esse membro não será usado.
É sempre aceitável especificar os tipos de codificação de certificado e mensagem combinando-os com uma operação OR bit a bit, conforme mostrado no exemplo a seguir:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Tipos de codificação definidos atualmente são:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
dwOpenFlags
Se um repositório do sistema for aberto com o local de repositório SERVICES ou USERS, o local do repositório dwOpenFlags será definido como CERT_SYSTEM_STORE_USERS ou CERT_SYSTEM_STORE_SERVICES.
OpenParameters
Um CRYPT_DATA_BLOB que contém dados a serem passados para o parâmetro pvPara da função CertOpenStore . O tipo de dados depende do provedor especificado. Para obter informações detalhadas sobre o tipo e o conteúdo a serem passados, consulte descrições de provedores disponíveis no CertOpenStore.
dwFlags
Os seguintes valores dwFlags para CERT_PHYSICAL_STORE_INFO são definidos.
| Valor | Significado |
|---|---|
|
Habilita a adição de um contexto ao repositório. |
|
Definido pela função CertRegisterPhysicalStore . Por padrão, todos os repositórios de sistema localizados no registro têm um repositório físico SystemRegistry implícito aberto. Para desabilitar a abertura desse repositório, o repositório físico SystemRegistry que corresponde ao repositório do sistema deve ser registrado definindo CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG ou registrando um repositório físico chamado ". Padrão" com CertRegisterPhysicalStore. |
|
Desabilita a abertura remota do repositório físico. |
|
Places a cadeia de caracteres \\ComputerName na frente de outros tipos de provedor. |
|
Permite que o CertOpenStore abra um repositório em relação a um HKEY especificado pelo usuário em vez de uma das constantes HKEY predefinidas. Por exemplo, HKEY_CURRENT_USER pode ser substituído por um HKEY especificado pelo usuário. Quando CERT_SYSTEM_STORE_RELOCATE_FLAG é definido, o parâmetro pvPara passado para CertOpenStore aponta para uma estrutura CERT_SYSTEM_STORE_RELOCATE_PARA em vez de apontar para o nome do repositório como uma cadeia de caracteres Unicode ou ASCII terminada em nulo. |
dwPriority
Quando um repositório do sistema é aberto, seus repositórios físicos são ordenados de acordo com suas configurações de dwPriority . Um dwPriority mais alto indica prioridade mais alta. O membro dwPriority é passado para CertAddStoreToCollection.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | wincrypt.h |