QualifierSet_Delete function

Artikkeli
09/15/2021

Deletes a specified qualifier by name.

Note

This API is for internal use only. It's not intended for use from developer code.

Syntax

HRESULT QualifierSet_Delete (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName
);

Parameters

vFunc
[in] This parameter is unused.

ptr [in] A pointer to an IWbemQualifierSet instance.

wszName [in] The name of the qualifier to delete.

Return value

The following values returned by this function are defined in the WbemCli.h header file, or you can define them as constants in your code:

Constant	Value	Description
`WBEM_E_INVALID_PARAMETER`	0x80041008	The `wszName` parameter is not valid.
`WBEM_E_INVALID_OPERATION`	0x80041016	Deleting this qualifier is illegal.
`WBEM_E_NOT_FOUND`	0x80041002	The specified qualifier was not found.
`WBEM_S_NO_ERROR`	0	The function call was successful.
`WBEM_S_RESET_TO_DEFAULT`	0x40002	The local override was deleted and the original qualifier from the parent object has resumed scope.

Remarks

This function wraps a call to the IWbemQualifierSet::Delete method.

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, the QualifierSet_Delete method resets the qualifier to its original inherited value. The function in this case returns the status code WBEM_S_RESET_TO_DEFAULT.

Requirements

Platforms: See System Requirements.

Header: WMINet_Utils.idl

.NET Framework Versions: Available since 4.7.2

Jaa