HP Operations Manager for Windows

 

IOvPmdLicenseInfo Interface Reference

License information interface. More...

import "pmad.idl";

Inheritance diagram for IOvPmdLicenseInfo:

IOvPmdLicenseInfo2 IOvPmdLicenseInfo80 List of all members.

Public Member Functions
HRESULT  AddPolicy ([in]BSTR sProductId,[in] IOvPmdLogicalPolicy *pPolicy)
HRESULT  AddPackage ([in]BSTR sProductId,[in] IOvPmdPackage *pPackage)
HRESULT  GetProductName ([in] BSTR sProductId,[out, retval] BSTR *psProductName)
HRESULT  ReportNodes ([in]BSTR sProductId,[out, retval]SAFEARRAY(IDispatch *)*ppNodeList)
HRESULT  ReportProductsForNode ([in]BSTR sNodeName,[out, retval]SAFEARRAY(BSTR)*pProductIds)
HRESULT  ReportProductForPolicy ([in] IOvPmdLogicalPolicy *pPolicy,[out, retval]BSTR *psProductId)
HRESULT  ReportProductForPackage ([in] IOvPmdPackage *pPackage,[out, retval]BSTR *psProductId)
HRESULT  ReportPoliciesForProduct ([in] BSTR sProductId,[out, retval]SAFEARRAY(IDispatch *)*ppPolicies)
HRESULT  ReportPackagesForProduct ([in] BSTR sProductId,[out, retval]SAFEARRAY(IDispatch *)*ppPackages)
HRESULT  ReportProducts ([out, retval]SAFEARRAY(BSTR)*pProductIds)

Detailed Description

The interface IOvPmdLicenseInfo provides methods to add licensed products to the server, to link policies and packages to products, and to report the licensing status of policies and packages.
Since:
6.x

Member Function Documentation

HRESULT IOvPmdLicenseInfo::AddPackage (  [in] BSTR  sProductId,
[in] IOvPmdPackage *  pPackage
) 
 
Semantics:
Adds a package version to the licensed product, which is specified by its product ID. Every node where the package version is deployed requires a license for the product afterwards. If the package version has already been assigned to a licensed product, this operation does nothing. If the product ID has not yet been added to PMAD using the method IOvPmdLicenseInfo80::AddLicensedProduct(...), an error is returned.
Parameters:
sProductId  - ID string of the license product as defined by the IOvPmdLicenseInfo80::AddLicensedProduct(...) method.
pPackage  - Interface pointer to the package version to be licensed.
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::AddPolicy (  [in] BSTR  sProductId,
[in] IOvPmdLogicalPolicy *  pPolicy
) 
 
Semantics:
Adds a policy version to the licensed product, which is specified by its product ID. Every node where the policy version is deployed requires a license for the product afterwards. If the policy version has already been assigned to a licensed product, this operation does nothing. If the product ID has not yet been added to PMAD using the method IOvPmdLicenseInfo80::AddLicensedProduct(...), an error is returned.
Parameters:
sProductId  - ID string of the licensed product, as defined by the IOvPmdLicenseInfo80::AddLicensedProduct(...) method.
pPolicy  - Interface pointer to the policy version to be licensed.
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::GetProductName (  [in] BSTR  sProductId,
[out, retval] BSTR *  psProductName
) 
 
Semantics:
Returns the name of the licensed product.
Parameters:
sProductId  - ID of the licensed product.
psProductName  - Name of the licensed product.
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::ReportNodes (  [in] BSTR  sProductId,
[out, retval] SAFEARRAY(IDispatch *)*  ppNodeList
) 
 
Semantics:
Returns a SAFEARRAY of IDispatch interface pointers to all nodes where at least one package or policy is installed, which requires the licensed product specified by the product ID.
Parameters:
sProductId  - ID of the license product.
ppNodeList  - SAFEARRAY of IDispatch interface pointers to the managed nodes. Use the method "IOvPmdPolicyManager::CVar(...)" to access the elements of the array within a VB script.
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::ReportPackagesForProduct (  [in] BSTR  sProductId,
[out, retval] SAFEARRAY(IDispatch *)*  ppPackages
) 
 
Semantics:
Returns a SAFEARRAY of IDispatch interface pointers to all package versions, which require a license for the specified product.
Parameters:
sProductId  - ID of the licensed product.
ppPackages  - SAFEARRAY of IDispatch interface pointers to the package versions. Use the method "IOvPmdPolicyManager::CVar(...)" to access the elements of the array within a VB script.
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::ReportPoliciesForProduct (  [in] BSTR  sProductId,
[out, retval] SAFEARRAY(IDispatch *)*  ppPolicies
) 
 
Semantics:
Returns a SAFEARRAY of IDispatch interface pointers to all policy versions, which require a license for the specified product.
Parameters:
sProductId  - ID of the licensed product.
ppPolicies  - SAFEARRAY of IDispatch interface pointers to the policy versions. Use the method "IOvPmdPolicyManager::CVar(...)" to access the elements of the array within a VB script.
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::ReportProductForPackage (  [in] IOvPmdPackage *  pPackage,
[out, retval] BSTR *  psProductId
) 
 
Semantics:
Returns the ID of the licensed product to which the specified package is assigned. The value is empty if the package version is not licensed.
Parameters:
pPackage  - IOvPmdPackage interface pointer to the package version.
psProductId  - The ID of the licensed product to which the specified package version is assigned.
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::ReportProductForPolicy (  [in] IOvPmdLogicalPolicy *  pPolicy,
[out, retval] BSTR *  psProductId
) 
 
Semantics:
Returns the ID of the licensed product to which the specified policy is assigned. The value is empty if the policy version is not licensed.
Parameters:
pPolicy  - IOvPmdLogicalPolicy interface pointer to the policy version.
psProductId  - ID of the licensed product to which the specified policy version is assigned.
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::ReportProducts (  [out, retval] SAFEARRAY(BSTR)*  pProductIds  ) 
 
Semantics:
Returns a SAFEARRAY with the IDs of all licensed products stored in PMAD.
Parameters:
pProductIds  - SAFEARRAY of strings that represent the IDs of all licensed products stored in PMAD
Possible errors:
Database communication errors
Since:
6.x
HRESULT IOvPmdLicenseInfo::ReportProductsForNode (  [in] BSTR  sNodeName,
[out, retval] SAFEARRAY(BSTR)*  pProductIds
) 
 
Semantics:
Returns a SAFEARRAY of strings with the IDs of all licensed products that are required by at least one package or policy installed on the specified node.
Parameters:
sNodeName  - ID of the node for which the product IDs are reported.
pProductIds  - SAFEARRAY containing the IDs of all products installed on the specified node.
Possible errors:
Database communication errors
Since:
6.x