Función CryptCATCDFEnumCatAttributes (mscat.h)

[La función CryptCATCDFEnumCatAttributes está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La función CryptCATCDFEnumCatAttributes enumera los atributos de nivel de catálogo dentro de la sección CatalogHeader de un archivo de definición de catálogo (CDF). MakeCat llama a CryptCATCDFEnumCatAttributes.

Sintaxis

CRYPTCATATTRIBUTE * CryptCATCDFEnumCatAttributes(
  [in] CRYPTCATCDF                  *pCDF,
  [in] CRYPTCATATTRIBUTE            *pPrevAttr,
  [in] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Parámetros

[in] pCDF

Puntero a una estructura CRYPTCATCDF .

[in] pPrevAttr

Puntero a una estructura CRYPTCATATTRIBUTE para un atributo de catálogo en el CDF al que apunta pCDF.

[in] pfnParseError

Puntero a una función definida por el usuario para controlar los errores de análisis de archivos.

Valor devuelto

Tras la operación correcta, esta función devuelve un puntero a una estructura CRYPTCATATTRIBUTE . La función CryptCATCDFEnumCatAttributes devuelve un puntero NULL si se produce un error.

Comentarios

Normalmente, se llama a esta función en un bucle para enumerar todos los atributos de encabezado de catálogo en una CDF. Antes de escribir el bucle, establezca pPrevAttr en NULL. La función devuelve un puntero al primer atributo. Establezca pPrevAttr en el valor devuelto de la función para las iteraciones posteriores del bucle.

Ejemplos

En el ejemplo siguiente se muestra la secuencia correcta de asignaciones para el parámetro pPrevAttr (pAttr).

    CRYPTCATCDF         *pCDF;
    CRYPTCATATTRIBUTE   *pAttr;

    pCDF = CryptCATCDFOpen(L"myCDF", NULL);
    
    pAttr = NULL;

    while (pAttr = CryptCATCDFEnumCatAttributes(pCDF, pAttr, NULL))
    {
        //do something with pAttr
    }

    CryptCATCDFClose(pCDF);

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mscat.h
Archivo DLL	Wintrust.dll

Consulte también

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat