Directory Services

IADsClass::Qualifiers

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

HRESULT Qualifiers( 
  IADsCollection** ppQualifiers
);

Parameters

ppQualifiers: [out] Address of an 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.

For more information and other return values, see ADSI Error Codes.

Return Code	Description
S_OK	The IADsCollection interface pointer was retrieved successfully.
E_FAIL	The operation failed.
E_NOTIMPL	The method is not supported by the given provider.

Remarks

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

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

Example Code [Visual Basic]

The following code example shows how to use this method.

Dim ads As IADs
Dim cls As IADsClass
On Error GoTo Cleanup

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

Cleanup:
	If (Err.Number<>0) Then
		MsgBox("An error has occurred. " & Err.Number)
	End If
	Set ads = Nothing
	Set cls = Nothing

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.