Partilhar via


Função CryptCATPersistStore (mscat.h)

[A função CryptCATPersistStore 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 CryptCATPersistStore salva as informações no repositório de catálogo especificado em um arquivo de catálogo sem sinal.

Sintaxe

BOOL CryptCATPersistStore(
  [in] HANDLE hCatalog
);

Parâmetros

[in] hCatalog

Um identificador para o catálogo obtido da função CryptCATHandleFromStore ou CryptCATOpen . A partir do Windows 8, você deve usar apenas CryptCATOpen para recuperar um identificador.

Valor de retorno

O valor retornado será TRUE se a função for bem-sucedida; caso contrário, FALSE.

Se essa função retornar FALSE, informações de erro adicionais poderão ser obtidas chamando a função GetLastError . GetLastError retornará o código de erro a seguir.

Código de retorno Description
ERROR_INVALID_PARAMETER
Um ou mais dos parâmetros não são válidos.
ERROR_NOT_SUPPORTED
A partir do Windows 8 e do Windows Server 2012, você deve recuperar um identificador chamando a função CryptCATOpen com o parâmetro dwPublicVersion definido como 0x100 ou 0x200. Para obter mais informações, consulte Comentários.

Observações

A estrutura CRYPTCATSTORE deve ser inicializada antes de chamar CryptCATPersistStore.

A partir do Windows 8 e do Windows Server 2012, as seguintes alterações se aplicam a esta função:

  • Se CryptCATOpen foi chamado com um parâmetro dwPublicVersion de 0x200, o catálogo será escrito usando o formato v2.
  • Se CryptCATOpen foi chamado com um parâmetro dwPublicVersion de 0x100, o catálogo será escrito usando o formato v1.
  • Se CryptCATOpen foi chamado com um parâmetro dwPublicVersion diferente de 0x200 ou 0x100, a função CryptCATPersistStore retornará FALSE e o código de erro será definido como ERROR_NOT_SUPPORTED.

Requirements

Requirement Value
Cliente mínimo suportado Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header mscat.h
Library Wintrust.lib
de DLL Wintrust.dll