Función GetNextLogArchiveExtent (clfsw32.h)
Recupera el siguiente conjunto de extensiones de archivo en un contexto de archivo de registro. El contexto de archivo de registro describe un conjunto contiguo de extensiones de archivo que abarcan la instantánea del registro activo capturado por las capturas PrepareLogArchive . GetNextLogArchiveExtent mantiene un cursor en el conjunto ordenado de descriptores de archivo de registro para que las llamadas posteriores permitan a una aplicación recorrer en iteración todo el conjunto.
Sintaxis
CLFSUSER_API BOOL GetNextLogArchiveExtent(
[in] CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
[in, out] CLFS_ARCHIVE_DESCRIPTOR [] rgadExtent,
[in] ULONG cDescriptors,
[out] PULONG pcDescriptorsReturned
);
Parámetros
[in] pvArchiveContext
Puntero a un contexto de archivo que se obtiene mediante una llamada a PrepareLogArchive.
El contexto mantiene el estado del cursor, que permite la iteración a través del conjunto de extensiones de archivo en el archivo. El cliente de archivo es responsable de desasignar el contexto mediante la función TerminateLogArchive .
[in, out] rgadExtent
Matriz asignada por el cliente de estructuras de CLFS_ARCHIVE_DESCRIPTOR que esta función rellenará.
[in] cDescriptors
Número de elementos de la matriz rgadExtent .
Este valor es el número máximo de descriptores de archivo que esta función puede recuperar.
[out] pcDescriptorsReturned
Número de descriptores de la matriz rgadExtent rellenada por esta función.
Si este valor es menor que cDescriptors, se agota el conjunto de descriptores y el cliente de archivo puede finalizar la iteración mediante el conjunto de descriptores ordenados. Se produce un error en las llamadas adicionales a esta función con ERROR_NO_MORE_ENTRIES.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero (0). Para obtener información de error extendida, llame a GetLastError. En la lista siguiente se identifican los posibles códigos de error:
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | clfsw32.h |
| Library | Clfsw32.lib |
| Archivo DLL | Clfsw32.dll |