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 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 |
|---|---|
|
Um ou mais dos parâmetros não são válidos. |
|
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 |