Platform SDK: Active Directory, ADSI, and Directory Services

IADsClass::Qualifiers

The IADsClass::Qualifiers method is an optional method that returns a collection of ADSI objects describing additional qualifiers for this schema class.

HRESULT IADsClass::Qualifiers(
  IADsCollection ** ppQualifiers  
);

Parameters

ppQualifiers
[out] Address of IADsCollection* pointer variable that receives the interface pointer to the ADSI collection object that represents additional limits for this schema class.

Return Values

This method supports the standard return values, as well as the following:

S_OK
The IADsCollection interface pointer has been successfully retrieved.
E_FAIL
The operation has failed.
E_NOTIMPL
The method is not supported by the given provider.

For other return values, see ADSI Error Codes.

Remarks

The qualifier objects are provider-specific. When supported, this method can be used to obtain extended schema information.

This method is not currently supported by any of the providers supplied by Microsoft®.

Example Code [Visual Basic]

The following Visual Basic® code snippet illustrates how to use this method.

Dim ads As IADs
Dim cls As IADsClass
Set ads = GetObject("WinNT://myComputer, computer")
Set cls = GetObject(ads.Schema)
 
' Show the user where to look for additional class info.
ListBox.additem "Additional class info can be found from:"
For each q in cls.Qualifiers
    listBox.additem q.Name 
Next

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with DSClient).
  Windows 95/98: Requires Windows 95 or later (with DSClient).
  Header: Declared in Iads.h.

See Also

IADsClass, IADsProperty::Qualifiers