IADsClass-Eigenschaftenmethoden

Die Eigenschaftenmethoden der IADsClass-Schnittstelle erhalten oder legen die folgenden Eigenschaften fest. Weitere Informationen finden Sie unter Schnittstelleneigenschaftsmethoden.

Eigenschaften

Zusammenfassung

Boolescher Wert, der angibt, ob diese Klasse abstrakt oder nicht abstrakt ist. True gibt an, dass diese Klasse eine abstrakte Klasse ist und nicht direkt im Verzeichnisdienst instanziiert werden kann. Abstrakte Klassen können nur als Superklassen verwendet werden.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BOOLEAN

// C++ method syntax
HRESULT get_Abstract(
  [out] BOOLEAN* pbAbstract
);
HRESULT put_Abstract(
  [in] BOOLEAN bAbstract
);

AuxDerivedFrom

Array von ADsPath-Zeichenfolgen, die die super Auxiliary-Klassen angeben, von denen diese Klasse ableiten.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_AuxDerivedFrom(
  [out] VARIANT* pvAuxDerivedFrom
);
HRESULT put_AuxDerivedFrom(
  [in] VARIANT vAuxDerivedFrom
);

Hilfs

Boolescher Wert, der angibt, ob diese Klasse "Auxiliary" ist. True gibt an, dass diese Klasse eine Auxiliary-Klasse ist und nicht direkt im Verzeichnisdienst instanziiert werden kann. Hilfsklassen können nur als Superklassen anderer Hilfsklassen oder als Quelle zusätzlicher Eigenschaften für strukturelle Klassen verwendet werden.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BOOLEAN

// C++ method syntax
HRESULT get_Auxiliary(
  [out] BOOLEAN* pbAuxiliary
);
HRESULT put_Auxiliary(
  [in] BOOLEAN bAuxiliary
);

Clsid

Optionale anbieterspezifische CLSID, die das COM-Objekt identifiziert, das diese Klasse implementiert.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_CLSID(
  [out] BSTR* pbstrCLSID
);
HRESULT put_CLSID(
  [in] BSTR bstrCLSID
);

Container

Boolescher Wert, der angibt, ob diese Klasse ein Container anderer Objektklassen sein kann. Wenn dieser Wert TRUE ist, können Sie die get _ Container-Methode aufrufen, um ein Array der Objektklassen zu erhalten, die diese Klasse enthalten kann.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BOOLEAN

// C++ method syntax
HRESULT get_Container(
  [out] BOOLEAN* pbContainer
);
HRESULT put_Container(
  [in] BOOLEAN bContainer
);

Containment

Ein BSTR-Array, in dem jedes Element der Name einer Objektklasse ist, die diese Klasse enthalten kann.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_Containment(
  [out] VARIANT* pvContainment
);
HRESULT put_Containment(
  [in] VARIANT vContainment
);

DerivedFrom

Array von ADsPath-Zeichenfolgen, die angeben, von welchen Klassen diese Klasse abgeleitet wurde.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_DerivedFrom(
  [out] VARIANT* pvDerivedFrom
);
HRESULT put_DerivedFrom(
  [in] VARIANT vDerivedFrom
);

HelpFileContext

Kontext-ID in HelpFileName, wobei bestimmte Informationen für diese Klasse gefunden werden können.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: long

// C++ method syntax
HRESULT get_HelpFileContext(
  [out] long* plHelpContext
);
HRESULT put_HelpFileContext(
  [in] long lHelpContext
);

HelpFileName

Name einer Hilfedatei, die weitere Informationen zu Objekten dieser Klasse enthält.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_HelpFileName(
  [out] BSTR* pbstrHelpFileName
);
HRESULT put_HelpFileName(
  [in] BSTR bstrHelpFileName
);

MandatoryProperties

SAFEARRAY von VARIANT-Objekten, die die Eigenschaften auflisten, die festgelegt werden müssen, damit diese Klasse in den Speicher geschrieben werden kann. Wenn die Klasse nur eine Eigenschaft enthält, gibt _ get MandatoryProperties einen BSTR zurück.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_MandatoryProperties(
  [out] VARIANT* pvarMandatoryProperties
);
HRESULT put_MandatoryProperties(
  [in] VARIANT varMandatoryProperties
);

NamingProperties

SAFEARRAY von BSTR s, das die Eigenschaften auflistet, die zum Benennen von Attributen dieser Schemaklasse verwendet werden.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_NamingProperties(
  [out] VARIANT* pvarNamingProperties
);
HRESULT put_NamingProperties(
  [in] VARIANT varNamingProperties
);

Oid

Anbieterspezifischer Objektbezeichner, der diese Klasse definiert. Dies wird bereitgestellt, um die Schemaerweiterung mithilfe von Active Directory in Verzeichnisdiensten zu ermöglichen, die anbieterspezifische OIDs für Klassen erfordern.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_OID(
  [out] BSTR* pbstrOID
);
HRESULT put_OID(
  [in] BSTR bstrOID
);

OptionalProperties

SAFEARRAY von VARIANT s, das die optionalen Eigenschaften für diese Schemaklasse auflistet. Wenn die Klasse nur eine Eigenschaft enthält, gibt get _ OptionalProperties einen BSTR zurück.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_OptionalProperties(
  [out] VARIANT* pvarOptionalProperties
);
HRESULT put_OptionalProperties(
  [in] VARIANT varOptionalProperties
);

PossibleSuperiors

Array von ADsPath-Zeichenfolgen, die die Schemaklassen angeben, die Instanzen dieser Klasse enthalten können.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_PossibleSuperiors(
  [out] VARIANT* pvSuperiors
);
HRESULT put_PossibleSuperiors(
  [in] VARIANT vSuperiors
);

PrimaryInterface

Optionale anbieterspezifische Bezeichner-GUID, die Objekten dieser Schemaklasse eine Schnittstelle zu ordnet. Beispielsweise wird die Klasse "User", die IADsUser und PrimaryInterface unterstützt, durch IID _ IADsUser identifiziert. Dies muss im standarden Zeichenfolgenformat einer GUID vorliegen, wie von COM definiert. Diese GUID ist der Wert, der in der IADs::get _ GUID-Eigenschaft in Instanzen dieser Klasse für Anbieter angezeigt wird, die diese Eigenschaft implementieren. Das Identifizieren einer Schemaklasse durch IID der primären Schnittstelle des Klassencodes ermöglicht die Verwendung von QueryInterface zur Laufzeit, um zu bestimmen, ob ein Objekt der gewünschten Klasse entspricht.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_PrimaryInterface(
  [out] BSTR* pbstrGUID
);

Beispiele

Das folgende Codebeispiel zeigt, wie die IADsClass-Schnittstelle verwendet wird, um zu bestimmen, ob ein Objekt ein Container sein kann, und listet in diesem Fall die Namen aller enthaltenen Objekte auf.

Dim ads As IADs
Dim cls As IADsClass

On Error GoTo Cleanup

Set ads = GetObject("WinNT://myComputer,computer")
Set cls = GetObject(ads.Schema)
if cls.Container = True Then
    MsgBox "This object contains the following children:"
    For Each o In cls.Containment
        MsgBox o
    Next
End If

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

Das folgende Codebeispiel zeigt, wie die IADsClass-Schnittstelle verwendet wird, um zu bestimmen, ob ein Objekt ein Container sein kann, und listet in diesem Fall die Namen aller enthaltenen Objekte auf.

HRESULT hr = S_OK;
IADsClass *pCls = NULL;
IADs *pADs = NULL;
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);
VARIANT_BOOL bCont;
pCls->get_Container(&bCont);
if(bCont != false) {
    VariantClear(&var);
    pCls->get_Containment(&var);
    hr = printVarArray(var);
}

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

    if(pCls)
        pCls->Release();

    SysFreeString(bstrSchema);
    CoUninitialize();

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Header
Iads.h
DLL
Activeds.dll
IID
IID _ IADsClass ist als C8F93DD0-4AE0-11CF-9E73-00AA004A5691 definiert.

Siehe auch

IADsClass

IADsClass::Qualifiers