Share via

3.2.4.10.1 GetResourceGroupInfo (Opnum 7)

  • Article

The GetResourceGroupInfo method gets information about the resource group with the specified ID. If the ID is "\", this method returns all selection criteria.

 [id(1), helpstring("method GetResourceGroupInfo")] HRESULT GetResourceGroupInfo(
   [in] BSTR bstrResourceGroupName,
   [out] BSTR* pbstrResourceGroupInfo
 );

bstrResourceGroupName: A string that specifies the name of the selection criteria.

If this parameter is NULL, E_INVALIDARG MUST be returned.

pbstrResourceGroupInfo: A pointer to a string that returns the selection criteria, in the form of a ProcessMatchingCriteria element (section 2.2.5.24). For an example, see the ProcessMatchingCriteria example (section 4.2.20).

If bstrResourceGroupName is "\", all resource groups MUST be returned, in the form of a ProcessMatchingCriteriaCollection element (section 2.2.5.25). For an example, see the ProcessMatchingCriteriaCollection example (section 4.2.21).

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 invalid. The name cannot start with a hyphen ("-"), cannot contain spaces, and cannot contain any of the following characters; "\" cannot be used with other characters.

 /   ? * | : < > " , ;

0xC1FF012E

WRM_ERR_RESOURCEGROUPID_INVALID

The request has been aborted because the specified resource group does not exist.

Additional IWRMResourceGroup interface methods are specified in section 3.2.4.10.