Función DeleteLogFile (clfsw32.h)

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 producirá un error en las solicitudes para abrir nuevos flujos de registro de cliente.

Nota 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 de :<nombre de registro>[::<nombre de flujo de registro>]

< nombre de 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 ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, 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	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 R2 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	clfsw32.h
biblioteca de	Clfsw32.lib
DLL de	Clfsw32.dll

Consulte también

funciones comunes del sistema de archivos de registro

CreateLogFile

DeleteLogByHandle

SECURITY_ATTRIBUTES