Función SetupGetIntField (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 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) |