3.2.4.7.10 GetProcessList (Opnum 16)

  • Article

The GetProcessList method returns a list of processes for a specified policy.

 [id(10), helpstring("method GetProcessList")] HRESULT GetProcessList(
   [in] BSTR bstrPolicyName,
   [out] BSTR* pbstrProcessList
 );

bstrPolicyName: Name of the policy for which a matching process list is to be returned.

If this parameter is NULL, E_INVALIDARG MUST be returned.

pbstrProcessList: A pointer to a string that returns a list of processes in the form of a ProcessList element (section 2.2.5.23). The data about matching processes is queried from the operating system to create the ProcessList element.

Return Values: This method returns 0x00000000 for success or a negative HRESULT value (in the following table or in [MS-ERREF] section 2.1.1) if an error occurs.

Return value/code

Description

0x00000000

S_OK

Operation successful.

0x80070057

E_INVALIDARG

One or more arguments are invalid.

0xC1FF006F

WRM_ERR_ID_VALUE

The specified name contains characters that are not valid. The name cannot start with a hyphen ("-"), cannot contain spaces, and cannot contain any of the following characters:

 \   / ? * | : < > " , ;

0xC1FF00C9

WRM_ERR_POLICYID_INVALID

The specified resource allocation policy does not exist.

Additional IWRMPolicy interface methods are specified in section 3.2.4.7.