2.2.6 WBEM_GENERIC_FLAG_TYPE Enumeration

  • Article

The WBEM_GENERIC_FLAG_TYPE enumeration is used to indicate and update the type of the flag.

 typedef [v1_enum] enum tag_WBEM_GENERIC_FLAG_TYPE
 {
   WBEM_FLAG_RETURN_WBEM_COMPLETE = 0x0,
   WBEM_FLAG_RETURN_IMMEDIATELY = 0x10,
   WBEM_FLAG_FORWARD_ONLY = 0x20,
   WBEM_FLAG_NO_ERROR_OBJECT = 0x40,
   WBEM_FLAG_SEND_STATUS = 0x80,
   WBEM_FLAG_ENSURE_LOCATABLE = 0x100,
   WBEM_FLAG_DIRECT_READ = 0x200,
   WBEM_MASK_RESERVED_FLAGS = 0x1F000,
   WBEM_FLAG_USE_AMENDED_QUALIFIERS = 0x20000,
   WBEM_FLAG_STRONG_VALIDATION = 0x100000
 } WBEM_GENERIC_FLAG_TYPE;

WBEM_FLAG_RETURN_WBEM_COMPLETE:  This flag makes the operation synchronous. This is the default behavior and so this flag need not be explicitly specified.

WBEM_FLAG_RETURN_IMMEDIATELY:  This flag causes the call to return without waiting for the operation to complete. The call result parameter contains the IWbemCallResult object by using the status of the operation that can be retrieved.

WBEM_FLAG_FORWARD_ONLY:  This flag causes a forward-only enumerator, IEnumWbemClassObject, (section 3.1.4.4), to be returned. Forward-only enumerators are typically much faster and use less memory than conventional enumerators; however, they do not allow calls to IEnumWbemClassObject::Clone or IEnumWbemClassObject::Reset.

WBEM_FLAG_NO_ERROR_OBJECT:  This flag MUST NOT be set, and MUST be ignored on receipt.

WBEM_FLAG_SEND_STATUS:  This flag registers a request with WMI to receive intermediate status reports through the client implementation of IWbemObjectSink::SetStatus, if supported by the server implementation.

WBEM_FLAG_ENSURE_LOCATABLE:  This flag ensures that any returned objects have enough information in them so that system properties, such as __PATH, __RELPATH, and __SERVER,<1> are non-NULL.

WBEM_FLAG_DIRECT_READ:  This flag causes direct access to the specified class without regard to its parent class or subclasses.

WBEM_MASK_RESERVED_FLAGS:  This flag MUST NOT be set, and MUST be ignored on receipt.

WBEM_FLAG_USE_AMENDED_QUALIFIERS:  If this flag is set, the server retrieves any qualifiers in the CIM object that can be localized in the current connection's locale. The set of localized qualifiers and the list of locales for which the qualifier is localized are implementation dependent. When the localized information is available, the server retrieves the localized values using the client-preferred locale. If the localized values are not available, the server returns values using the default locale.

The localized qualifiers or amended qualifiers are identified by the qualifier flavor as defined in [MS-WMIO] section 2.2.62.

If this flag is not set, the server does not retrieve any localized qualifiers for the CIM object.

WBEM_FLAG_STRONG_VALIDATION:  This flag MUST NOT be set, and MUST be ignored on receipt.