Función CryptCATCDFEnumMembersByCDFTagEx

[La función CryptCATCDFEnumMembersByCDFTagEx 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 CryptCATCDFEnumMembersByCDFTagEx enumera los miembros de archivo individuales de la sección CatalogFiles de un archivo de definición de catálogo (CDF). MakeCat llama a CryptCATCDFEnumMembersByCDFTagEx.

Nota

Esta función no tiene ningún archivo de encabezado asociado ni biblioteca de importación. Para llamar a esta función, debe crear un archivo de encabezado definido por el usuario y usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Mssign32.dll.

 

Sintaxis

LPWSTR WINAPI CryptCATCDFEnumMembersByCDFTagEx(
  _In_    CRYPTCATCDF                  *pCDF,
  _Inout_ LPWSTR                       pwszPrevCDFTag,
  _In_    PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError,
  _In_    CRYPTCATMEMBER               **ppMember,
  _In_    BOOL                         fContinueOnError,
  _In_    LPVOID                       pvReserved
);

Parámetros

pCDF [in]

Puntero a una estructura CRYPTCATCDF .

pwszPrevCDFTag [in, out]

Puntero a una cadena terminada en null que identifica el miembro del archivo de catálogo.

pfnParseError [in]

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

ppMember [in]

Puntero a una estructura CRYPTCATMEMBER que contiene la información del miembro del archivo.

fContinueOnError [in]

Valor que especifica si se debe mantener en memoria una referencia al último miembro enumerado.

pvReserved [in]

Este parámetro está reservado; no lo use.

Valor devuelto

Tras la operación correcta, esta función devuelve un puntero a una cadena terminada en null que identifica un miembro de archivo en la sección CatalogFiles de una CDF. La función CryptCATCDFEnumMembersByCDFTagEx devuelve un puntero NULL si se produce un error.

Comentarios

Normalmente, se llama a esta función en un bucle para enumerar todos los miembros del archivo de catálogo en una CDF. Antes de escribir el bucle, establezca pwszPrevCDFTag en NULL. La función devuelve un puntero al primer miembro. Establezca pwszPrevCDFTag 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 pwszPrevCDFTag (pwszMemberTag).

    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

    pCDF = CryptCATCDFOpen(L'myCDF', NULL);
    

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        //do something with pwszMemberTag and pMember
    }

    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]
Archivo DLL	Wintrust.dll

Consulte también

MakeCat

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary