3.2.4.6.7 GetMachineInfo (Opnum 13)

  • Article

The GetMachineInfo method returns information about a machine. If more than one machine with the specified bstrMachineId value exists in the hierarchy of machine groups, the information can be returned from any of the machine groups.

 [id(7), helpstring("method GetMachineInfo")] HRESULT GetMachineInfo(
   [in] BSTR bstrMachineId,
   [out] BSTR* pbstrMachineInfo
 );

bstrMachineId: A string that specifies the identifier of the machine for which to return information.

If this parameter is NULL, E_INVALIDARG MUST be returned.

pbstrMachineInfo: A pointer to a string that returns information about the machine, in the format specified in Machine element (section 2.2.5.17).

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.

0xC1FF038A

WRM_ERR_MACHINEID_INVALID

The specified machine ID is not found in any machine group of the configuration.<98>

Additional IWRMMachineGroup interface methods are specified in section 3.2.4.6.