Freigeben über


PowerDuplicateScheme-Funktion (powrprof.h)

Dupliziert ein vorhandenes Energieschema.

Syntax

DWORD PowerDuplicateScheme(
  [in, optional] HKEY       RootPowerKey,
  [in]           const GUID *SourceSchemeGuid,
  [in]           GUID       **DestinationSchemeGuid
);

Die Parameter

[in, optional] RootPowerKey

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf NULL festgelegt werden.

[in] SourceSchemeGuid

Der Bezeichner des Energieschemas, das dupliziert werden soll.

[in] DestinationSchemeGuid

Die Adresse eines Zeigers auf eine GUID. Wenn der Zeiger NULL enthält, weist die Funktion Speicher für eine neue GUID zu und platziert die Adresse dieses Speichers im Zeiger. Der Anrufer kann diesen Speicher mit LocalFree freigeben.

Rückgabewert

Gibt ERROR_SUCCESS (Null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ungleich Null, wenn der Aufruf fehlgeschlagen ist.

Zurückgeben von Code/Wert Description
ERROR_SUCCESS
0 (0x0)
Das Energieschema wurde erfolgreich dupliziert.
ERROR_INVALID_PARAMETER
87 (0x57)
Einer der Parameter ist ungültig.
ERROR_ALREADY_EXISTS
183 (0xB7)
Der Parameter DestinationSchemeGuid bezieht sich auf ein vorhandenes Energieschema. PowerDeleteScheme kann zum Löschen dieses Schemas verwendet werden.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Nur Desktop-Apps]
Zielplattform Fenster
Header powrprof.h
Library PowrProf.lib
DLL PowrProf.dll

Siehe auch

Power Management-Funktionen