Función SetupOpenAppendInfFileA (setupapi.h)

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

La función SetupOpenAppendInfFile anexa la información de un archivo INF a un archivo INF abierto anteriormente por SetupOpenInfFile.

Sintaxis

WINSETUPAPI BOOL SetupOpenAppendInfFileA(
  [in]      PCSTR FileName,
  [in]      HINF  InfHandle,
  [in, out] PUINT ErrorLine
);

Parámetros

[in] FileName

Si no es NULL, FileName apunta a una cadena terminada en null que contiene el nombre (y, opcionalmente, la ruta de acceso) del archivo INF que se va a abrir. Si el nombre de archivo no contiene caracteres separadores de ruta de acceso, se busca primero en el directorio %windir%\inf y, a continuación, en el directorio %windir%\system32. Si el nombre de archivo contiene caracteres separadores de ruta de acceso, se supone que es una especificación de ruta de acceso completa y no se realiza ningún procesamiento adicional en él. Si FileName es NULL, el nombre de archivo INF se recupera del valor LayoutFile de la sección Versión del archivo INF existente. La misma lógica de búsqueda se aplica al nombre de archivo recuperado de la clave LayoutFile.

[in] InfHandle

Identificador INF existente al que se anexará este archivo INF.

[in, out] ErrorLine

Puntero opcional a una variable a la que esta función devuelve el número de línea (basado en 1) donde se produjo un error durante la carga del archivo INF. Este valor es generalmente confiable solo si GetLastError no devuelve ERROR_NOT_ENOUGH_MEMORY. Si se produce una condición de memoria insuficiente, ErrorLine puede ser 0.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor 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.

Si no se especificó FileName y no había ningún valor LayoutFile en la sección Versión del archivo INF existente, GetLastError devuelve ERROR_INVALID_DATA.

Comentarios

Esta función requiere un archivo INF de Windows. Es posible que no se admita algunos formatos de archivo INF más antiguos. En este caso, la función devuelve FALSE y GetLastError devolverá ERROR_INVALID_PARAMETER. El propósito principal de esta función es combinar un archivo INF con la información de ubicación del archivo de origen contenida en el archivo especificado en la entrada LayoutFile de la sección Versión (normalmente, LAYOUT. INF).

El ERROR_WRONG_INF_STYLE también puede ser devuelto por SetupOpenAppendInfFile si el archivo INF usa un formato anterior.

Nota

El encabezado setupapi.h define SetupOpenAppendInfFile 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	setupapi.h
Library	Setupapi.lib
Archivo DLL	Setupapi.dll

Vea también

Funciones

Información general

SetupCloseInfFile

SetupOpenInfFile