estrutura CERT_PHYSICAL_STORE_INFO (wincrypt.h)

Artigo
08/27/2023

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
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG	Habilita a adição de um contexto ao repositório.
CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG	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.
CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG	Desabilita a abertura remota do repositório físico.
CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG	Places a cadeia de caracteres \\ComputerName na frente de outros tipos de provedor.
CERT_SYSTEM_STORE_RELOCATE_FLAG	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

Confira também

CertAddStoreToCollection

Certopenstore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction

Compartilhar via