Compartilhar via


Função CanUserWritePwrScheme (powrprof.h)

[CanUserWritePwrScheme está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Os aplicativos escritos para o Windows Vista e posterior devem usar PowerSettingAccessCheck em vez disso.]

Determina se o usuário atual tem privilégio suficiente para escrever um esquema de energia.

Sintaxe

BOOLEAN CanUserWritePwrScheme();

Retornar valor

Se o usuário atual tiver privilégio suficiente para escrever um esquema de energia, a função retornará TRUE.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Os valores de erro possíveis incluem o seguinte.

Erro do Significado
ERROR_ACCESS_DENIED
O usuário atual não tem privilégio suficiente para escrever um esquema de energia.

Comentários

Essa função será útil se o aplicativo estiver representando um usuário.

Para obter mais informações sobre como usar PowrProf.h, consulte Power Schemes.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho powrprof.h
Biblioteca PowrProf.lib
DLL PowrProf.dll

Confira também

Funções de gerenciamento de energia

Esquemas de energia

WritePwrScheme