SetupQuerySourceList

The SetupQuerySourceList function queries the current list of installation sources. The list is built from the system and user-specific lists, and potentially overridden by a temporary list (see SetupSetSourceList).

BOOL SetupQuerySourceList(
  DWORD Flags,    // specifies the list to query
  PCTSTR **List,  // receives an array of sources
  PUINT Count     // number of sources in the array
);
 

Parameters

Flags

These flags specify which list to query. This parameter can be any combination of the following values:

SRCLIST_SYSTEM

Query the system list.

SRCLIST_USER

Query the per-user list.

Note If the system and the user lists are both retrieved, they are merged with those items in the system list that appear first.

If none of the preceding flags are specified, the entire current (merged) list is returned.

SRCLIST_NOSTRIPPLATFORM

Normally, all paths are stripped of a platform-specific component if it is the final component. For example, a path stored in the registry as f:\mips is returned as f:\. If this flag is specified, the platform-specific component is not stripped.

List

Supplies a pointer to a caller-supplied variable in which this function returns a pointer to an array of sources. The caller must free this array with a call to SetupFreeSourceList.

Count

Supplies a pointer to a caller-supplied variable in which this function returns the number of sources in the list.

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.

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, SetupSetSourceList