Интерфейс IADsClass (iads.h)

  • Статья

Интерфейс IADsClass предназначен для управления объектами класса схемы, которые предоставляют определения классов для любого объекта ADSI. Другие интерфейсы управления схемами включают IADsProperty для определений атрибутов и IADsSyntax для синтаксиса атрибута.

Наследование

Интерфейс IADsClass наследуется от IDispatch и IAD. IADsClass также имеет следующие типы членов:

Методы

Интерфейс IADsClass содержит следующие методы.

 
IADsClass::Qualifiers

Возвращает коллекцию объектов ADSI, описывающих дополнительные квалификаторы для этого класса схемы.

Комментарии

Объекты схемы упорядочены в контейнере схемы заданного каталога. Чтобы получить доступ к классу схемы объекта, используйте свойство Schema объекта (а именно вызовите метод свойства IADs::get_Schema ), чтобы получить строку ADsPath и использовать ее для привязки к объекту класса схемы.

Примеры

В следующем примере кода показано, как реализовать интерфейс IADsClass .

Dim obj As IADs
Dim cls As IADsClass

On Error GoTo Cleanup

Set obj = GetObject("WinNT://myMachine,computer")
Set cls = GetObject(obj.Schema)
 
' Inspecting mandatory and optional properties.
For Each p In cls.MandatoryProperties
    MsgBox "Must-have: " & p
Next
For Each p In cls.OptionalProperties
    MsgBox "May-have: " & p
Next

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

В следующем примере кода показано, как реализовать интерфейс IADsClass .

HRESULT hr = S_OK;
IADsClass *pCls = NULL;
IADs *pADs;
BSTR bstrSchema;
VARIANT var;
 
hr = CoInitialize(NULL);
hr = ADsGetObject(L"WinNT://myComputer,computer",
                  IID_IADs,
                  (void**)&pADs);
if (FAILED(hr)) { goto Cleanup;}
 
hr = pADs->get_Schema(&bstrSchema);
pADs->Release();
if(FAILED(hr)) { goto Cleanup; }
 
hr = ADsGetObject(bstrSchema, IID_IADsClass, (void**)&pCls);
if(FAILED(hr)) { goto Cleanup; }
 
VariantInit(&var);
pCls->get_MandatoryProperties(&var);
hr = printVarArray(var);
 
VariantClear(&var);
pCls->get_OptionalProperties(&var);
hr = printVarArray(var);

Cleanup:
    if(pCls)
        pCls->Release();

    if(pADs)
        pADs->Release();

    SysFreeString(bstrSchema);
    VariantClear(&var);
    CoUninitialize();
    return hr;

В следующем примере кода показано, как реализовать функцию printVarArray .

HRESULT printVarArray(VARIANT var)
{
    LONG lstart, lend;
    VARIANT varItem;
    HRESULT hr;
    SAFEARRAY *sa = V_ARRAY( &var );
    hr = SafeArrayGetLBound( sa, 1, &lstart );
    hr = SafeArrayGetUBound( sa, 1, &lend );
    VariantInit(&varItem);
    for ( long idx=lstart; idx <= lend; idx++ ) {
        hr = SafeArrayGetElement( sa, &idx, &varItem );
        printf("   %S \n", V_BSTR(&varItem));
        VariantClear(&varItem);
    }
    printf("\n");
    return S_OK;
}

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header iads.h

См. также раздел

IAD

IADsContainer

IADsProperty

IADsSyntax

IDispatch