SetupGetIntField

The SetupGetIntField function retrieves an integer value from the specified field of a line in an INF file.

BOOL SetupGetIntField(
  PINFCONTEXT Context,  // context of a line in an INF file
  DWORD FieldIndex,     // index of an integer field in the line
  PINT IntegerValue     // receives the retreived integer field
);
 

Parameters

Context

Pointer to the context for a line in an INF file.

FieldIndex

The 1-based index of the field within the specified line from which the integer should be retrieved.

A FieldIndex of 0 can be used to retrieve an integer key (For example, consider the following INF line, 431 = 1, 2, 4. The value 431 would be put into the variable pointed at by IntegerValue if SetupGetIntField was called with a FieldIndex of 0).

Integer Value

Pointer to a caller-supplied variable that receives the integer. If the field is not an integer, the function fails and a call to GetLastError returns ERROR_INVALID_DATA.

Return Values

If the function succeeds, the return value is a non-zero value.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The integer field may start with a positive (+) or negative (-) sign. It will be interpreted as a decimal number, unless it is prefixed in the file with 0x or 0X, in which case it is hexadecimal.

QuickInfo

  Windows NT: Use version 4.0 and later.
  Windows: Use Windows 95 and later.
  Windows CE: Unsupported.
  Header: Declared in setupapi.h.
  Import Library: Link with setupapi.lib.

See Also

Overview, Functions, SetupGetBinaryField, SetupGetMultiSzField, SetupGetStringField