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

Consulte también

CLFS_ARCHIVE_DESCRIPTOR

Funciones comunes del sistema de archivos de registro