Función SetupGetIntField (setupapi.h)

Artículo
03/01/2024

[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 usándose para instalar controladores de dispositivos.

La función SetupGetIntField recupera un valor entero del campo especificado de una línea en un archivo INF.

Sintaxis

WINSETUPAPI BOOL SetupGetIntField(
  [in]  PINFCONTEXT Context,
  [in]  DWORD       FieldIndex,
  [out] PINT        IntegerValue
);

Parámetros

[in] Context

Puntero al contexto de una línea de un archivo INF.

[in] FieldIndex

Índice basado en 1 del campo dentro de la línea especificada desde la que se debe recuperar el entero.

Un FieldIndex de 0 se puede usar para recuperar una clave entera (por ejemplo, considere la siguiente línea INF, 431 = 1, 2, 4. El valor 431 se colocaría en la variable a la que apunta IntegerValue si se llamó a SetupGetIntField con un FieldIndex de 0).

[out] IntegerValue

Puntero a una variable que recibe el entero. Si el campo no es un entero, se produce un error en la función y una llamada a GetLastError devuelve ERROR_INVALID_DATA.

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.

Comentarios

El campo entero puede comenzar con un signo positivo (+) o negativo (-). Se interpretará como un número decimal, a menos que esté prefijo en el archivo con 0x o 0X, en cuyo caso es hexadecimal.

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
Conjunto de API	ext-ms-win-setupapi-inf-l1-1-1 (introducido en Windows 10, versión 10.0.14393)