WcmSetProfileList-Funktion (wcmapi.h)

Die WcmSetProfileList-Funktion ordnet eine Profilliste oder eine Teilmenge einer Profilliste neu an.

Syntax

DWORD WcmSetProfileList(
  [in] WCM_PROFILE_INFO_LIST *pProfileList,
  [in] DWORD                 dwPosition,
  [in] BOOL                  fIgnoreUnknownProfiles,
       void                  *pReserved
);

Parameter

[in] pProfileList

Typ: WCM_PROFILE_INFO_LIST*

Die Liste der Profile, die neu angeordnet werden sollen, wird in der bevorzugten Reihenfolge bereitgestellt (absteigend von der am meisten bevorzugten zur am wenigsten bevorzugten).

[in] dwPosition

Art: DWORD

Gibt die Position in der Liste an, an der die Neuanordnung gestartet werden soll.

[in] fIgnoreUnknownProfiles

Typ: BOOL

True, wenn profile in pProfileList , die nicht vorhanden sind, ignoriert werden sollen; Der Anruf wird mit dem Rest der Liste fortgesetzt. False, wenn der Aufruf fehlschlagen soll, ohne die Profilreihenfolge zu ändern, wenn keine Profile in pProfileList vorhanden sind.

pReserved

Typ: PVOID

Reserviert.

Rückgabewert

Art: DWORD

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen Fehlerwert zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wcmapi.h
Bibliothek	wcmapi.lib
DLL	Wcmapi.dll

Weitere Informationen

WCM_PROFILE_INFO_LIST