Función DeleteLogFile (clfsw32.h)

  • Artículo

Marca un registro para su eliminación. El registro se elimina realmente cuando se cierran todos los identificadores, las áreas de serialización y los contextos de lectura del registro. Si el registro es un registro físico, se eliminan sus contenedores subyacentes.

Cuando se marca un registro para su eliminación, se produce un error en las solicitudes para abrir nuevas secuencias de registro de cliente.

Nota Una función estrechamente relacionada es DeleteLogByHandle, que elimina un registro cuando se le asigna el identificador del archivo.

 

Sintaxis

CLFSUSER_API BOOL DeleteLogFile(
  [in]           LPCWSTR pszLogFileName,
  [in, optional] PVOID   pvReserved
);

Parámetros

[in] pszLogFileName

Nombre del registro.

Este nombre se especifica al crear el registro mediante CreateLogFile. En el ejemplo siguiente se identifica el formato que se va a usar:

Registro:<log name>[::<log stream name>]

<nombre del> registro corresponde a una ruta de acceso de archivo válida en el sistema de archivos.

<nombre >de flujo de registro es el nombre único de una secuencia de registro en el registro.

Para obtener más información, consulte Tipos de registro.

[in, optional] pvReserved

Este parámetro está reservado y debe establecerse en NULL.

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

Consulte también

Funciones comunes del sistema de archivos de registro

CreateLogFile

DeleteLogByHandle

SECURITY_ATTRIBUTES