Função CryptCATOpen (mscat.h)

Artigo
03/08/2023

[A função CryptCATOpen está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A função CryptCATOpen abre um catálogo e retorna um identificador de contexto para o catálogo aberto.

Nota Algumas versões mais antigas do Wintrust.lib não contêm as informações de exportação para essa função. Nesse caso, você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Wintrust.dll.

Sintaxe

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

Parâmetros

[in] pwszFileName

Um ponteiro para uma cadeia de caracteres terminada em nulo para o nome do arquivo de catálogo.

[in] fdwOpenFlags

Zero, para abrir um arquivo de catálogo existente ou uma combinação bit a bit de um ou mais dos valores a seguir.

Valor	Significado
CRYPTCAT_OPEN_ALWAYS	Abre o arquivo, se ele existir, ou cria um novo arquivo, se necessário.
CRYPTCAT_OPEN_CREATENEW	Um novo arquivo de catálogo é criado. Se existir um arquivo criado anteriormente, ele será substituído.
CRYPTCAT_OPEN_EXISTING	Um arquivo de catálogo existente é aberto.
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES	Um arquivo de catálogo existente é aberto. Excluir hashes de página em SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES	Um arquivo de catálogo existente é aberto. Inclua hashes de página em SPC_INDIRECT_DATA. O CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES acima terá precedência se também estiver definido.
CRYPTCAT_OPEN_VERIFYSIGHASH	Um arquivo de catálogo existente é aberto. Verifica a assinatura, não os certificados.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG	Um arquivo de catálogo existente é aberto. O CryptMsgDecode não tem conteúdo.
CRYPTCAT_OPEN_SORTED	Um arquivo de catálogo existente é aberto. Faz CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG).

[in] hProv

Um identificador para um provedor de serviços criptográficos (CSP).

[in] dwPublicVersion

Versão do arquivo Esse pode ser um dos valores a seguir.

Valor	Significado
CRYPTCAT_VERSION_1 0x100	Formato de arquivo versão 1.
CRYPTCAT_VERSION_2 0x200	Formato de arquivo versão 2. Windows 8 e Windows Server 2012: O suporte para esse valor começa.

[in] dwEncodingType

Tipo de codificação usado para o arquivo. Se esse valor for 0, o tipo de codificação será definido como PKCS_7_ASN_ENCODING | X509_ASN_ENCODING.

Valor retornado

Após o sucesso, essa função retorna um identificador para o catálogo aberto. Quando terminar de usar o identificador, feche-o chamando a função CryptCATClose . A função CryptCATOpen retornará INVALID_HANDLE_VALUE se falhar.

Requisitos


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]
Plataforma de Destino	Windows
Cabeçalho	mscat.h
Biblioteca	Wintrust.lib
DLL	Wintrust.dll

Confira também

CryptCATClose

Compartilhar via