Función ImageEnumerateCertificates (imagehlp.h)
Recupera información sobre los certificados contenidos actualmente en un archivo de imagen.
Sintaxis
BOOL IMAGEAPI ImageEnumerateCertificates(
[in] HANDLE FileHandle,
[in] WORD TypeFilter,
[out] PDWORD CertificateCount,
[in, out] PDWORD Indices,
[in, optional] DWORD IndexCount
);
Parámetros
[in] FileHandle
Identificador del archivo de imagen que se va a examinar. Este identificador debe abrirse para FILE_READ_DATA acceso.
[in] TypeFilter
Tipo de sección de certificado que se va a usar como filtro al devolver información del certificado. CERT_SECTION_TYPE_ANY se debe pasar para obtener información sobre todos los tipos de sección presentes en la imagen.
[out] CertificateCount
Puntero a una variable que recibe el número de certificados de la imagen que contiene secciones del tipo especificado por el parámetro TypeFilter . Si no se encuentra ninguno, este parámetro es cero.
[in, out] Indices
Opcionalmente, proporciona un búfer que se usará para devolver una matriz de índices a los certificados que contienen secciones del tipo especificado. No se debe asumir ninguna ordenación para los valores de índice, ni se garantiza que sean contiguos cuando se consulta CERT_SECTION_TYPE_ANY.
[in, optional] IndexCount
Tamaño del búfer índices , en DWORDs. Este parámetro se examinará cada vez que los índices estén presentes. Si CertificateCount es mayor que IndexCount, los índices se rellenarán con las primeras secciones de IndexCount que se encuentran en la imagen; ningún otro no se devolverá.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es TRUE.
Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.
Comentarios
La función ImageEnumerateCertificates devuelve información sobre los certificados contenidos actualmente en un archivo de imagen. Tiene funcionalidades de filtrado que permiten que se devuelvan certificados que contengan secciones de cualquier tipo (o de cualquier tipo).
Una vez detectados los índices de certificados interesantes, se pueden pasar a la función ImageGetCertificateData para obtener los cuerpos reales de los certificados.
Todas las funciones ImageHlp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.
Requisitos
| 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 | imagehlp.h |
| Library | Imagehlp.lib |
| Archivo DLL | Imagehlp.dll |