Enumeration Constants

The __WSManEnumFlags enumeration contains constants, as listed in the following list, used in the flags parameter by calls to Session.Enumerate and IWSManSession::Enumerate.

Be aware that WSManFlagReturnObject and WSManFlagHierarchyDeep are the default if the flags parameter is not specified.

WSManFlagReturnObject

0 (0x0)

Batches contain the requested XML instances. This is the default value for the flag parameter.

The associated scripting method is WSMan.EnumerationFlagReturnObject and the C++ method is IWSManEx.EnumerationFlagReturnObject.

WSManFlagNonXmlText

1 (0x1)

This flag controls how the filter parameter in the call to Session.Enumerate is interpreted by WinRM.

The format of the filter may be an XML fragment or a string of plain text. The format is determined by the filter dialect of the filter used in the call to Session.Enumerate or IWSManSession::Enumerate, which is specific to the operation performed.

If the dialect parameter is not specified, WinRM attempts to determine the dialect based on the first character of the filter. If the first character is <, but the filter is not actually an XML fragment, then this flag should be set. For example, a filter in the following format requires that you set WSManFlagNonXmlText so that the filter is correctly interpreted:

<25 && > 1

If the filter is an XML fragment, then this flag is not required because the fragment starts with <, which WinRM correctly interprets as XML. For example,

<filter>select * from aDataStructure</filter>

If the filter is in plain text that does not start with <, then this flag is not required. For example,

select * from aDataStructure

The associated scripting method is WSMan.EnumerationFlagNonXmlText and the C++ method is IWSManEx.EnumerationFlagNonXmlText.

EnumerationFlagReturnEPR

2 (0x2)

Batches contain endpoint references (EPRs) for the corresponding XML instances, but not the actual instances.

The associated scripting method is WSMan.EnumerationFlagReturnEPR and the C++ method is IWSManEx.EnumerationFlagReturnEPR.

WSManFlagReturnObjectAndEPR

4 (0x4)

Batches contain both the requested XML instances and the corresponding EPRs contained in a wsman:Items element.

The associated scripting method is WSMan.EnumerationFlagReturnObjectAndEPR and the C++ method is IWSManEx.EnumerationFlagReturnObjectAndEPR.

WSManFlagHierarchyDeep

0 (0x0)

Derived class instances are included and are represented according to their actual schemas.

The associated scripting method is WSMan.EnumerationFlagHierarchyDeep and the C++ method is IWSManEx.EnumerationFlagHierarchyDeep.

WSManFlagHierarchyShallow

32 (0x20)

Derived class instances are excluded. Only instances of the requested type are shown.

The associated scripting method is WSMan.EnumerationFlagHierarchyShallow and the C++ method is IWSManEx.EnumerationFlagHierarchyShallow.

WSManFlagHierarchyDeepBasePropsOnly

64 (0x40)

Derived class instances are included and are represented according to the base class schema. Properties defined in the derived class are not shown.

The associated scripting method is WSMan.EnumerationFlagHierarchyDeepBasePropsOnly and the C++ method is IWSManEx.EnumerationFlagHierarchyDeepBasePropsOnly.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	WSManDisp.h
IDL	WSManDisp.idl

See also

WinRM Constants and Enumerations

Enumerating or Listing All the Instances of a Resource

Querying for Specific Instances of a Resource