Funzione CryptCATCDFOpen (mscat.h)

Articolo
03/05/2024

[La funzione CryptCATCDFOpen è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Struttura CRYPTCATCDF . CryptCATCDFOpen viene chiamato da MakeCat.

Sintassi

CRYPTCATCDF * CryptCATCDFOpen(
  [in]           LPWSTR                       pwszFilePath,
  [in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Parametri

[in] pwszFilePath

Puntatore a una stringa con terminazione null contenente il percorso del file CDF da aprire.

[in, optional] pfnParseError

Puntatore a una funzione definita dall'utente per gestire gli errori di analisi dei file.

Valore restituito

Al termine dell'operazione, questa funzione restituisce un puntatore alla struttura CRYPTCATCDF appena creata. La funzione CryptCATCDFOpen restituisce un puntatore NULL se ha esito negativo.

Commenti

I valori predefiniti seguenti vengono usati dalla funzione CryptCATCDFOpen per le condizioni specificate nella sezione CatalogHeader CDF.

Condizione CatalogHeader	Valore predefinito
Non è specificato alcun valore Name .	Il nome del file in pwszFilePath viene usato per il file di output catalog (.cat).
Non viene specificato alcun valore PublicVersion .	0x00000001
Non è specificato alcun valore EncodingType .	PKCS_7_ASN_ENCODING o X509_ASN_ENCODING ( 0x00010001 )

Le azioni seguenti vengono eseguite dalla funzione CryptCATCDFOpen per determinate condizioni di errore.

Condizione di errore	Azione eseguita
Non sono disponibili tag CatalogHeader o Name in CDF.	Se specificato dal chiamante, la funzione CryptCATCDFOpen chiama la funzione specificata da pfnParseError e restituisce un puntatoreNULL .
La funzione CryptCATCDFOpen chiama la funzione CryptCATOpen per ottenere un handle al file di output del catalogo (.cat), ma ottiene un handle null o non valido.	Chiama la funzione CryptCATCDFClose e restituisce un puntatoreNULL .

Unità OID aggiuntive per il ramo del catalogo	Definizione
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: Gli OID del catalogo aggiuntivi non sono disponibili.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mscat.h
DLL	Wintrust.dll

Vedi anche

Condividi tramite