SetupQuerySourceList
[New
- Windows NT]
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 TRUE.
If the
function fails, the return value is FALSE. To get extended error information,
call GetLastError.
See Also