Condividi tramite

Metodi della proprietà IADsClass

  • Articolo

I metodi di proprietà dell'interfaccia IADsClass ottengono o impostano le proprietà seguenti. Per altre informazioni, vedere Metodi di proprietà dell'interfaccia.

Proprietà

Contenuto

Valore booleano che indica se questa classe è Abstract o non astratta. Se TRUE, questa classe è una classe Abstract e non può essere creata direttamente nell'istanza del servizio directory. Le classi astratte possono essere usate solo come classi con privilegi avanzati.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BOOLEAN

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

AuxDerivedFrom

Matrice di stringhe ADsPath che indicano le classi super Ausiliarie da cui deriva questa classe.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: VARIANT

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

Ausiliario

Valore booleano che indica se questa classe è ausiliaria o meno. Se TRUE, questa classe è una classe ausiliaria e non può essere creata direttamente nell'istanza del servizio directory. Le classi ausiliarie possono essere usate solo come classi super di altre classi ausiliarie o come fonte di proprietà aggiuntive sulle classi strutturali.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BOOLEAN

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

CLSID

CLSID specifico del provider facoltativo che identifica l'oggetto COM che implementa questa classe.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Contenitore

Valore booleano che indica se questa classe può essere un contenitore di altre classi oggetto. Se questo valore è TRUE, è possibile chiamare il metodo get_Container per ottenere una matrice delle classi oggetto che questa classe può contenere.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BOOLEAN

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

Containment

Matrice BSTR in cui ogni elemento è il nome di una classe oggetto che questa classe può contenere.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: VARIANT

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

DerivedFrom

Matrice di stringhe ADsPath che indicano le classi da cui è stata derivata questa classe.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: VARIANT

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

HelpFileContext

ID di contesto all'interno di HelpFileName in cui sono disponibili informazioni specifiche per questa classe.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: long

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

HelpFileName

Nome di un file della Guida che contiene ulteriori informazioni sugli oggetti di questa classe.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Proprietà obbligatorie

SAFEARRAY di VARIANTche elenca le proprietà che devono essere impostate affinché questa classe venga scritta nell'archiviazione. Se la classe contiene solo una proprietà, get_MandatoryProperties restituirà un valore BSTR.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: VARIANT

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

Proprietà di denominazione

SAFEARRAY di BSTRche elenca le proprietà utilizzate per denominare gli attributi di questa classe dello schema.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: VARIANT

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

OID

Identificatore di oggetto specifico del provider che definisce questa classe. Questa opzione viene fornita per consentire l'estensione dello schema, usando Active Directory, nei servizi directory che richiedono URI specifici del provider per le classi.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Proprietà facoltative

SAFEARRAY di VARIANTche elenca le proprietà facoltative per questa classe dello schema. Se la classe contiene solo una proprietà, get_OptionalProperties restituirà un valore BSTR.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: VARIANT

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

PossibleSuperiors

Matrice di stringhe ADsPath che indicano le classi dello schema che possono contenere istanze di questa classe.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: VARIANT

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

PrimaryInterface

GUID identificatore specifico del provider facoltativo che associa un'interfaccia agli oggetti di questa classe dello schema. Ad esempio, la classe "User" che supporta IADsUser e PrimaryInterface viene identificata da IID_IADsUser. Deve essere nel formato stringa standard di un GUID, come definito da COM. Questo GUID è il valore visualizzato nella proprietà IADs::get_GUID in istanze di questa classe per i provider che implementano questa proprietà. L'identificazione di una classe dello schema in base all'IID dell'interfaccia primaria del codice di classe consente l'uso di QueryInterface in fase di esecuzione per determinare se un oggetto è della classe desiderata.

Tipo di accesso: sola lettura

Tipo di dati scripting: BSTR

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

Esempio

Nell'esempio di codice seguente viene illustrato come usare l'interfaccia IADsClass per determinare se un oggetto può essere un contenitore e, in tal caso, elenca i nomi di qualsiasi oggetto contenuto.

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

Nell'esempio di codice seguente viene illustrato come usare l'interfaccia IADsClass per determinare se un oggetto può essere un contenitore e, in tal caso, elenca i nomi di qualsiasi oggetto contenuto.

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();

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Intestazione
Iads.h
DLL
Activeds.dll
IID
 IID_IADsClass è definito come C8F93DD0-4AE0-11CF-9E73-00AA004A5691

Vedi anche

IADsClass

IADsClass::Qualificatori