Função CryptCATPersistStore (mscat.h)

  • Artigo

[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 não assinado.

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 retornado

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 Descrição
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.

Comentários

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 essa função:

  • Se CryptCATOpen foi chamado com um parâmetro dwPublicVersion de 0x200, o catálogo é escrito usando o formato v2.
  • Se CryptCATOpen foi chamado com um parâmetro dwPublicVersion de 0x100, o catálogo é 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.

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