Função CryptCATCDFOpen (mscat.h)
[A função CryptCATCDFOpen 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 estrutura CRYPTCATCDF . CryptCATCDFOpen é chamado por MakeCat.
Sintaxe
CRYPTCATCDF * CryptCATCDFOpen(
[in] LPWSTR pwszFilePath,
[in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);
Parâmetros
[in] pwszFilePath
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho do arquivo CDF a ser aberto.
[in, optional] pfnParseError
Um ponteiro para uma função definida pelo usuário para tratar erros de análise de arquivo.
Retornar valor
Após o êxito, essa função retorna um ponteiro para a estrutura CRYPTCATCDF recém-criada. A função CryptCATCDFOpen retornará um ponteiro NULL se falhar.
Comentários
Os valores padrão a seguir são usados pela função CryptCATCDFOpen para determinadas condições na seção CatalogHeader do CDF.
| Condição CatalogHeader | Valor padrão |
|---|---|
| Nenhum valor de Nome é especificado. | O nome do arquivo em pwszFilePath é usado para o arquivo de saída do catálogo (.cat). |
| Nenhum valor de PublicVersion é especificado. | 0x00000001 |
| Nenhum valor EncodingType é especificado. | PKCS_7_ASN_ENCODING ou X509_ASN_ENCODING (0x00010001) |
As ações a seguir são executadas pela função CryptCATCDFOpen para determinadas condições de erro.
| Condição de erro | Ação realizada |
|---|---|
| Nenhuma marca CatalogHeader ou Name é encontrada no CDF. | Se especificado pelo chamador, a função CryptCATCDFOpen chamará a função especificada por pfnParseError e retornará um ponteiro NULL . |
| A função CryptCATCDFOpen chama a função CryptCATOpen para obter um identificador para o arquivo de saída do catálogo (.cat), mas obtém um identificador nulo ou inválido. | Chama a função CryptCATCDFClose e retorna um ponteiro NULL . |
| OIDs adicionais para o branch catálogo | Definição |
|---|---|
| szOID_CATALOG_LIST_MEMBER_V2 | 1.3.6.1.4.1.311.12.1.3 |
| CAT_MEMBERINFO2_OBJID | 1.3.6.1.4.1.311.12.2.3 |
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Os OIDs adicionais do Catálogo não estão disponíveis.
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] |
| Plataforma de Destino | Windows |
| Cabeçalho | mscat.h |
| DLL | Wintrust.dll |