HP Operations Manager for Windows

IOvReqCheck2::GetAllRequirements2


Return a list of prerequisites for all supported systems.

HRESULT GetAllRequirements2(
[in, optional] VARIANT AgentCommType,
[in, optional] VARIANT AgentBinaryFormat,
[in, defaultvalue(RP_TXT)] ReportFormat rpFormat,
[out, retval] BSTR* Requirements
);

Parameters

AgentCommType
Value of this parameter (VARIANT of type string) is copied to variable AGENT_COMM_TYPE. If parameter is not specified (VARIANT of type Empty), variable is defined as empty string. Possible values:
  • "DCE"
  • "HTTPS"
AgentBinaryFormat
Value of this parameter (VARIANT of type Int16) is copied to variable AGENT_BINARY_FORMAT. If parameter is not specified (VARIANT of type Empty), variable is defined as empty string. As opposite to method GetRequirements2, this method doesn’t validate parameter AgentBinaryFormat – tag [AGT_BIN_FRMT] is ignored.

rpFormat
Specifies the format of the returned list of prerequisites For valid values, see CheckNode.

Returning Parameter

Requirements
String containing a list of the prerequisites for all supported systems.

HRESULT Return Values

If not ovrcNoError, IErrorInfo is created, and a detailed error description is traced.

ovrcNoError
Method executed successfully.

ovrcErrCannotOpenFile
Prerequisite check configuration file cannot be accessed.

ovrcErrCannotReadFile
Prerequisite check configuration file cannot be read.

ovrcErrCannotCloseFile
Prerequisite check configuration file cannot be closed.

ovrcErrMgmtServerNotSet
UseManagementServer method was not called. Each client should first call the UseManagementServer method to set the management server from which the prerequisite check configuration should be used.

ovrcErrConfigFileSyntax
Syntax of the prerequisite check configuration file is not valid.

(other FAILED)
Another type of error occurred.

Description

The GetAllRequirements2 is similar as method IOvReqCheck::GetAllRequirements. You can specify the agent communication type and agent binary format.

The GetAllRequirements2 method returns the list of prerequisites for all of the supported systems. The format (XML/TXT) of the report is defined with the rpFormat parameter.

Note NOTE:
Variable AGENT_COMM_TYPE / AGENT_BINARY_FORMAT is defined as empty string if parameter AgentCommType / AgentBinaryFormat is not specified.