writePwrScheme 函式 (powrprof.h)

發行項
03/01/2024

[WritePwrScheme 已不再可供從 Windows Vista 使用。請改用 PowerEnumerate 函式來列舉指定配置的電源設定，並使用電源寫入函式來寫入個別設定。]

寫入指定電源配置唯一的原則設定。

語法

BOOLEAN WritePwrScheme(
  [in]           PUINT         puiID,
  [in]           LPCWSTR       lpszSchemeName,
  [in, optional] LPCWSTR       lpszDescription,
  [in]           PPOWER_POLICY lpScheme
);

參數

[in] puiID

要寫入之電源配置的索引。如果具有相同索引的電源配置已經存在，則會加以取代。否則，會建立新的電源配置。

[in] lpszSchemeName

電源配置的名稱。

[in, optional] lpszDescription

電源配置的描述。

[in] lpScheme

包含要寫入之電源原則設定之POWER_POLICY 結構的指標。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

這項變更不會影響目前的系統電源原則。若要將此變更套用至目前的系統電源原則，請使用此電源配置的索引呼叫 SetActivePwrScheme 函式。

使用 WritePwrScheme 撰寫的電源原則配置會永久儲存在系統登錄區中，並保留在 Power Options 控制面板程式中使用，或後續呼叫電源配置 API。若要從系統永久移除電源配置，請呼叫 DeletePwrScheme 函式。

如需使用 PowrProf.h 的詳細資訊，請參閱 Power Schemes。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	powrprof.h
程式庫	PowrProf.lib
Dll	PowrProf.dll