Windows Dev Center

IWbemClassObject::GetPropertyQualifierSet method

The IWbemClassObject::GetPropertyQualifierSet method gets the qualifier set for a particular property in the class object. You can use this method with properties that are a member of an instance or a class definition.

Syntax


HRESULT GetPropertyQualifierSet(
  [in]  LPCWSTR           wszProperty,
  [out] IWbemQualifierSet **ppQualSet
);

Parameters

wszProperty [in]

Property for which the qualifier set is requested. This cannot be NULL and must point to a valid LPCWSTR. The property can be local or propagated from the parent class. Note that system properties have no qualifiers so this method returns the error code WBEM_E_SYSTEM_PROPERTY if you attempt to obtain the IWbemQualifierSet pointer for a system property.

ppQualSet [out]

Receives an interface pointer that allows access to the qualifiers for the named property. The caller must call IWbemQualifierSet::Release on the pointer when access to the object is no longer required. The property is set to point to NULL when there are error conditions. A new object is not returned.

Return value

This method returns an HRESULT indicating the status of the method call. The following table lists the value contained within an HRESULT. For general HRESULT values, see System Error Codes.

Return codeDescription
WBEM_E_FAILED

There has been a general failure.

WBEM_E_NOT_FOUND

The specified property does not exist.

WBEM_E_OUT_OF_MEMORY

There was not enough memory to complete the operation.

WBEM_E_SYSTEM_PROPERTY

There was an attempt to get qualifiers on a system property.

WBEM_S_NO_ERROR

The call succeeded.

WBEM_E_INVALID_PARAMETER

A specified parameter is not valid.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

WbemCli.h (include Wbemidl.h)

IDL

WbemCli.idl

Library

WbemUuid.lib

DLL

CIMWin32.dll;
Esscli.dll;
Evntrprv.dll;
Fastprox.dll;
Framedyn.dll;
Krnlprov.dll;
Ncprov.dll;
Wbemcore.dll;
Wbemess.dll;
Wmipiprt.dll

CLSID

CLSID_WbemClassObject is defined as 9A653086-174F-11d2-B5F9-00104B703EFD

IID

IID_IWbemClassObject is defined as dc12a681-737f-11cf-884d-00aa004b2e24

See also

IWbemClassObject
IWbemQualifierSet

 

 

Show:
© 2015 Microsoft