CryptCATCDFOpen function
[The CryptCATCDFOpen function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
The CryptCATCDFOpen function opens an existing catalog definition file (CDF) for reading and initializes a CRYPTCATCDF structure. CryptCATCDFOpen is called by MakeCat.
Syntax
CRYPTCATCDF* WINAPI CryptCATCDFOpen( _In_ LPWSTR pwszFilePath, _In_opt_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError );
Parameters
- pwszFilePath [in]
-
A pointer to a null-terminated string that contains the path of the CDF file to open.
- pfnParseError [in, optional]
-
A pointer to a user-defined function to handle file parse errors.
Return value
Upon success, this function returns a pointer to the newly created CRYPTCATCDF structure. The CryptCATCDFOpen function returns a NULL pointer if it fails.
Remarks
The following default values are used by the CryptCATCDFOpen function for given conditions in the CDF CatalogHeader section.
| CatalogHeader condition | Default value |
|---|---|
|
No Name value is specified. |
The file name in pwszFilePath is used for the catalog (.cat) output file. |
|
No PublicVersion value is specified. |
0x00000001 |
|
No EncodingType value is specified. |
PKCS_7_ASN_ENCODING or X509_ASN_ENCODING (0x00010001) |
The following actions are performed by the CryptCATCDFOpen function for given error conditions.
| Error condition | Action performed |
|---|---|
|
No CatalogHeader or Name tags are found in CDF. |
If specified by the caller, the CryptCATCDFOpen function calls the function specified by pfnParseError and returns a NULL pointer. |
|
The CryptCATCDFOpen function calls the CryptCATOpen function to get a handle to the catalog (.cat) output file, but it gets an invalid or NULL handle. |
Calls the CryptCATCDFClose function and returns a NULL pointer. |
| Additional OIDs for the Catalog branch | Definition |
|---|---|
|
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 and Windows XP: The additional Catalog OIDs are not available.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
DLL |
|
See also