IADsClass 介面 (iads.h)

發行項
02/29/2024

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;
}