WHEAErrorSourceMethods::GetErrorSourceInfoRtn method

The WHEAErrorSourceMethods::GetErrorSourceInfoRtn WMI provider method returns an error source descriptor structure that describes a particular error source that is supported by the hardware platform.

Syntax


void GetErrorSourceInfoRtn(
  [out, retval] uint32 *Status,
  [in]          uint32 ErrorSourceId,
  [out, retval] uint32 *Length,
  [out, retval] uint8  *ErrorSourceInfo[]
);

Parameters

Status [out, retval]

The result of the call to the WHEAErrorSourceMethods::GetErrorSourceInfoRtn method. The value that is returned is an NTSTATUS code.

ErrorSourceId [in]

The identifier of the error source for which the error source descriptor structure is being obtained.

Length [out, retval]

The size, in bytes, of the buffer that is returned in the ErrorSourceInfo parameter.

ErrorSourceInfo[] [out, retval]

A pointer to a buffer that contains a WHEA_ERROR_SOURCE_DESCRIPTOR structure.

Return value

None

Remarks

A user-mode WHEA management application calls the WHEAErrorSourceMethods::GetErrorSourceInfoRtn method to get an error source descriptor structure that describes a particular error source that is supported by the hardware platform.

A user-mode WHEA management application can retrieve a list of WHEA_ERROR_SOURCE_DESCRIPTOR structures that describe all of the error sources that are supported by the hardware platform by calling the WHEAErrorSourceMethods::GetAllErrorSourcesRtn method.

A user-mode WHEA management application can change the configuration of an error source by modifying the contents of the WHEA_ERROR_SOURCE_DESCRIPTOR structure that describes the error source and then passing that modified structure to the WHEAErrorSourceMethods::SetErrorSourceInfoRtn method.

A user-mode WHEA management application does not call the WHEAErrorSourceMethods::GetErrorSourceInfoRtn method directly. It must call it indirectly by calling the IWbemServices::ExecMethod method. For more information about how to call methods in WMI provider classes, see the Calling a Provider Method topic in the Microsoft Windows SDK documentation.

Requirements

Target platform

Version

Supported in Windows Server 2008, Windows Vista SP1, and later versions of Windows.

See also

WHEAErrorSourceMethods::GetAllErrorSourcesRtn
WHEAErrorSourceMethods::SetErrorSourceInfoRtn
WHEA_ERROR_SOURCE_DESCRIPTOR

 

 

Send comments about this topic to Microsoft

Show: