Función DeleteLogByHandle (clfsw32.h)

Marca el registro especificado 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 Esta función difiere de DeleteLogFile, ya que toma un identificador abierto válido para el objeto de registro en lugar del nombre del registro.
 

Sintaxis

CLFSUSER_API BOOL DeleteLogByHandle(
  [in] HANDLE hLog
);

Parámetros

[in] hLog

Identificador de un registro abierto que se obtiene mediante una llamada correcta a CreateLogFile. El registro debe haberse creado con el acceso DELETE o no puede eliminar el registro.

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

DeleteLogFile