Función SetupRemoveFileLogEntryA (setupapi.h)

[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue usándose para instalar controladores de dispositivo.]

La función SetupRemoveFileLogEntry quita una entrada o sección de un registro de archivos.

Sintaxis

WINSETUPAPI BOOL SetupRemoveFileLogEntryA(
  [in] HSPFILELOG FileLogHandle,
  [in] PCSTR      LogSectionName,
  [in] PCSTR      TargetFilename
);

Parámetros

[in] FileLogHandle

Controle el registro de archivos tal como lo devuelve SetupInitializeFileLog. El autor de la llamada no debe haber pasado SPFILELOG_QUERYONLY cuando se inicializó el archivo de registro.

[in] LogSectionName

Puntero a un cadena terminada en nullque especifica el nombre de una agrupación lógica de nombres dentro del archivo de registro. Necesario para los registros que no son del sistema. De lo contrario, LogSectionName puede ser NULL.

[in] TargetFilename

Puntero a un cadena terminada en nullque especifica el nombre del archivo tal como existe en el destino. Este nombre debe tener el formato que sea significativo para el autor de la llamada. Si NULL , se quita la sección especificada por LogSectionName. No se puede quitar la sección principal.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Nota

El encabezado setupapi.h define SetupRemoveFileLogEntry como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	setupapi.h
biblioteca de	Setupapi.lib
DLL de	Setupapi.dll

Consulte también

funciones de

información general

setupLogFile