AppPolicyGetLifecycleManagement function (appmodel.h)

Retrieves a value indicating whether a process can be suspended/resumed by the Process Lifecycle Manager (PLM). You can use the value to decide whether to subscribe to relevant notifications from the PLM, or to register for a classic system suspend notification.

Syntax

LONG AppPolicyGetLifecycleManagement(
  [in]  HANDLE                       processToken,
  [out] AppPolicyLifecycleManagement *policy
);

Parameters

[in] processToken

A handle that identifies the access token for a process.

[out] policy

A pointer to a variable of the AppPolicyLifecycleManagement enumerated type. When the function returns successfully, the variable contains an enumerated constant value indicating whether the identified process is lifecycle-managed or not.

Return value

If the function succeeds, the function returns ERROR_SUCCESS.

If no known lifecycle management policy was found for the process token, the function raises a STATUS_ASSERTION_FAILURE exception and returns ERROR_NOT_FOUND.

If either processToken or policy are null, the function returns ERROR_INVALID_PARAMETER.

Requirements

Requirement	Value
Target Platform	Windows
Header	appmodel.h
Library	OneCoreUap.lib
DLL	Api-ms-win-appmodel-runtime-l1-1-2.dll