IWbemQualifierSet::Delete method

The IWbemQualifierSet::Delete method deletes the specified qualifier by name. Due to qualifier propagation rules, a particular qualifier may have been inherited from another object and merely overridden in the current class or instance. In this case, use the Delete method to reset the qualifier to the original inherited value.

Syntax


HRESULT Delete(
  [in] LPCWSTR wszName
);

Parameters

wszName [in]

Name of the qualifier to delete. The pointer is treated as read-only.

Return value

This method returns an HRESULT indicating the status of the method call. The following list lists the value contained withinan HRESULT.

WBEM_E_INVALID_OPERATION

Deleting this qualifier is illegal.

WBEM_E_INVALID_PARAMETER

The wszName parameter was not valid.

WBEM_E_NOT_FOUND

The specified qualifier was not found.

WBEM_S_NO_ERROR

The call succeeded.

WBEM_S_RESET_TO_DEFAULT

When deleting an overridden qualifier, this status code (a non-error code) indicates that the local override was deleted, and that the original qualifier from the parent object has resumed scope. A subsequent attempt to get the qualifier will succeed, returning the parent's value.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Wbemcli.h (include Wbemidl.h)

Library

Wbemuuid.lib

DLL

Fastprox.dll;
Krnlprov.dll;
Ncprov.dll;
Wbemcore.dll

See also

Qualifier Flavors

 

 

Show: