Función ScanLogContainers (clfsw32.h)

Artículo
02/28/2024

Enumera los contenedores de registro. Llame a esta función repetidamente para iterar en todos los contenedores de registro.

Sintaxis

CLFSUSER_API BOOL ScanLogContainers(
  [in, out]           PCLFS_SCAN_CONTEXT pcxScan,
  [in]                CLFS_SCAN_MODE     eScanMode,
  [in, out, optional] LPVOID             pReserved
);

Parámetros

[in, out] pcxScan

Puntero a una estructura de CLFS_SCAN_CONTEXT asignada por el cliente que inicializa la función CreateLogContainerScanContext .

[in] eScanMode

Modo para que se examinen los contenedores.

Los contenedores se pueden examinar en cualquiera de los siguientes modos de CLFS_SCAN_MODE .

Valor	Significado
CLFS_SCAN_INIT	Reinicializa el contexto de examen, pero no asigna el almacenamiento asociado. La inicialización es destructiva, porque se pierden todos los datos almacenados en el contexto de examen actual.
CLFS_SCAN_CLOSE	Anula la inicialización del contexto de examen y desasigna el almacenamiento del sistema asociado a un contexto de examen.
CLFS_SCAN_FORWARD	Hace que la siguiente llamada a ScanLogContainers continúe en una dirección hacia delante. No se puede usar si se especifica CLFS_SCAN_BACKWARD .
CLFS_SCAN_BACKWARD	Hace que la siguiente llamada a ScanLogContainers continúe en una dirección hacia atrás. No se puede usar si se especifica CLFS_SCAN_FORWARD .

[in, out, optional] pReserved

Reservado. Establezca pReserved enNULL.

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. Para obtener información de error extendida, llame a GetLastError.

En la lista siguiente se identifican los posibles códigos de error:

Comentarios

El identificador de un contenedor de registros se devuelve en: pcxScan-pinfoContainer-LogicalContainerId>>.

Nota Los contextos de examen del Sistema de archivos de registro común (CLFS) no son seguros para subprocesos. No deben usarse en más de un subproceso a la vez o pasarse a más de un examen asincrónico a la vez.

Ejemplos

Para obtener un ejemplo que usa esta función, consulte Enumeración de contenedores de registro.

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