PowerDuplicateScheme-Funktion (powrprof.h)

Artikel
08/25/2023

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

Freigeben über