A filter that defines what items in the resource are returned by the enumeration. When the resource is enumerated, only those items that match the filter criteria are returned. Including a filter parameter and a dialect parameter in an enumeration converts the enumeration into a query.

If you have an IWSManResourceLocator object for the resourceURI parameter, then this parameter should not be used. Instead, use the selector and fragment functionality of IWSManResourceLocator.

dialect [in, optional]

The language used by the filter. WQL, a subset of SQL used by WMI, is the only language supported.

If you have a IWSManResourceLocator object for the resourceURI parameter, then this parameter should not be used. Instead, use the selector and fragment functionality of IWSManResourceLocator.

flags [in]

This parameter must contain a flag in the __WSManEnumFlags enumeration. For more information, see Enumeration Constants.

Be aware that if the flags include the Enumeration ConstantsWSManFlagHierarchyDeepBasePropsOnly or WSManFlagHierarchyShallow then Windows Remote Management service returns the error code ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.

For more information about limiting network calls during an enumeration, see the BatchItems property.

If a filter is specified, it must be a valid document with respect to the schema of the resource. The dialect parameter is optional. However, if the filter string begins with <, but is not an XML fragment, then either include the dialect parameter or set the WSManFlagNonXmlText flag in the flags parameter. For more information, see Enumeration Constants.