PowerDuplicateScheme-Funktion (powrprof.h)

  • Artikel

Dupliziert ein vorhandenes Energieschema.

Syntax

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

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 Arbeitsspeicher für eine neue GUID zu und legt die Adresse dieses Arbeitsspeichers in den Zeiger. Der Aufrufer kann diesen Arbeitsspeicher mithilfe von LocalFree freigeben.

Rückgabewert

Gibt ERROR_SUCCESS (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ohne Zero, wenn der Aufruf fehlgeschlagen ist.

Rückgabecode/-wert BESCHREIBUNG
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 verweist auf ein vorhandenes Energieschema. PowerDeleteScheme kann verwendet werden, um dieses Schema zu löschen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile powrprof.h
Bibliothek PowrProf.lib
DLL PowrProf.dll

Weitere Informationen

Energieverwaltungsfunktionen