OV_ConfigFileVariety::GetVariety()
OV_ConfigFileVariety::GetVariety_Trans()

OV_Transaction GetVariety(

[in] string Application,

[in] string SubGroup,

[in] string Filename)

Parameters

Application

Application part of the existing variety.

SubGroup

SubGroup part of the existing variety.

Filename

Filename part of the existing variety.

Calling Convention

These methods can be called from a WMI class or instance object.

Description

Returns the node group (instance of OV_Transaction) specified with the properties Application, SubGroup, and Filename.

If the specified Application does not exist, the method fails with MDLAPI_E_CONFIGFILEVAR_APP_NOT_EXIST.

If the specified SubGroup does not exist under Application, the method fails with MDLAPI_E_CONFIGFILEVAR_SUBGRP_NOT_EXIST.

If the parameter Filename equals "<*>" (without quotes), there must be no Filename under the SubGroup. Otherwise, the method fails with MDLAPI_E_CONFIGFILEVAR_SUBGRP_NOT_EMPTY.

If the specified FileName does not exist under SubGroup, the method fails with MDLAPI_E_CONFIGFILEVAR_FNAME_NOT_EXIST.

Return Value

Instance of OV_Transaction specified with the properties Application, SubGroup, and Filename.

Extended Status Codes

MDLAPI_E_CONFIGFILEVAR_APP_NOT_EXIST

Specified Application does not exist.

MDLAPI_E_CONFIGFILEVAR_SUBGRP_NOT_EXIST

Specified Application does not have such a SubGroup.

MDLAPI_E_CONFIGFILEVAR_FNAME_NOT_EXIST

Specified SubGroup does not have such a Filename.

MDLAPI_E_CONFIGFILEVAR_SUBGRP_NOT_EMPTY

Specified SubGroup has one or more Filenames.

MDLAPI_E_TRANSACTION_NOT_EXIST

Transaction with the specified ID does not exist.