This topic has not yet been rated - Rate this topic

PowerDeterminePlatformRole function

Applies to: desktop apps only

Determines the computer role. To specify a platform, use the PowerDeterminePlatformRoleEx function.

Syntax

POWER_PLATFORM_ROLE WINAPI PowerDeterminePlatformRole(void);

Parameters

This function has no parameters.

Return value

The return value is one of the values from the POWER_PLATFORM_ROLE enumeration.

Remarks

This function reads the ACPI Fixed ACPI Description Table (FADT) to determine the OEM preferred computer role. If that information is not available, the function looks for a battery. If at least one battery is available, the function returns PlatformRoleMobile. If no batteries are available, the function returns PlatformRoleDesktop.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

PowrProf.h

Library

PowrProf.lib

DLL

PowrProf.dll

See also

Power Management Functions
POWER_PLATFORM_ROLE
PowerDeterminePlatformRoleEx

 

 

Send comments about this topic to Microsoft

Build date: 2/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
WMI access
I remember that either this article or the one about the asociated POWER_PLATFORM_ROLE enum used to mention how one may access the same info through WMI (PCSystemType on Win32_ComputerSystem). But this info is now gone. How come?