Función SetupOpenAppendInfFileA (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 SetupOpenAppendInfFile anexa la información de un archivo INF a un archivo INF abierto previamente por SetupOpenInfFile.

Sintaxis

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

Parámetros

[in] FileName

Si no NULL , FileName apunta a un cadena terminada en nullque 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 \inf de %windir%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 Version 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 se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

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

Observaciones

Esta función requiere un archivo INF de Windows. Es posible que no se admita algún formato de archivo INF anterior. 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 de (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 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

setupCloseInfFile

setupOpenInfFile