Partager via

IADsClass, méthodes de propriété

  • Article

Les méthodes de propriété de l’interface IADsClass obtiennent ou définissent les propriétés suivantes. Pour plus d’informations, consultez Méthodes de propriété d’interface.

Propriétés

Résumé

Valeur booléenne qui indique si cette classe est Abstraite ou non abstraite. Lorsqu’elle est TRUE, cette classe est une classe Abstract et ne peut pas être instanciée directement dans le service d’annuaire. Les classes abstraites ne peuvent être utilisées que comme super classes.

Type d'accès : lecture/écriture

Type de données de script : BOOLEAN

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

AuxDerivedFrom

Tableau de chaînes ADsPath qui indiquent les classes super auxiliaires dont cette classe dérive.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

Auxiliaire

Valeur booléenne qui indique si cette classe est Auxiliaire ou non. Quand true, cette classe est une classe Auxiliaire qui ne peut pas être instanciée directement dans le service d’annuaire. Les classes auxiliaires ne peuvent être utilisées que comme super classes d’autres classes auxiliaires ou comme source de propriétés supplémentaires sur les classes structurelles.

Type d'accès : lecture/écriture

Type de données de script : BOOLEAN

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

CLSID

CLSID facultatif propre au fournisseur identifiant l’objet COM qui implémente cette classe.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Conteneur

Valeur booléenne qui indique si cette classe peut être un conteneur d’autres classes d’objets. Si cette valeur est TRUE, vous pouvez appeler la méthode get_Container pour obtenir un tableau des classes d’objets que cette classe peut contenir.

Type d'accès : lecture/écriture

Type de données de script : BOOLEAN

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

Containment

Tableau BSTR dans lequel chaque élément est le nom d’une classe d’objet que cette classe peut contenir.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

DerivedFrom

Tableau de chaînes ADsPath qui indiquent de quelles classes cette classe a été dérivée.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

HelpFileContext

ID de contexte à l’intérieur de HelpFileName où se trouvent des informations spécifiques pour cette classe.

Type d'accès : lecture/écriture

Type de données de script : long

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

HelpFileName

Nom d’un fichier d’aide qui contient plus d’informations sur les objets de cette classe.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Propriétés obligatoires

SAFEARRAY de VARIANTs qui répertorie les propriétés qui doivent être définies pour que cette classe soit écrite dans le stockage. Si la classe ne contient qu’une seule propriété, get_MandatoryProperties retourne un BSTR.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

NamingProperties

SAFEARRAY des BSTRqui répertorie les propriétés utilisées pour nommer les attributs de cette classe de schéma.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

OID

Identificateur d’objet spécifique au fournisseur qui définit cette classe. Il est fourni pour autoriser l’extension de schéma, à l’aide d’Active Directory, dans les services d’annuaire qui nécessitent des OID spécifiques au fournisseur pour les classes.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

OptionalProperties

SAFEARRAY de VARIANTs qui répertorie les propriétés facultatives de cette classe de schéma. Si la classe ne contient qu’une seule propriété, get_OptionalProperties retourne un BSTR.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

PossibleSuperiors

Tableau de chaînes ADsPath qui indiquent les classes de schéma pouvant contenir des instances de cette classe.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

PrimaryInterface

GUID d’identificateur spécifique au fournisseur facultatif qui associe une interface à des objets de cette classe de schéma. Par exemple, la classe « User » qui prend en charge IADsUser et PrimaryInterface est identifiée par IID_IADsUser. Il doit être au format de chaîne standard d’un GUID, tel que défini par COM. Ce GUID est la valeur qui apparaît dans la propriété IADs::get_GUID dans les instances de cette classe pour les fournisseurs qui implémentent cette propriété. L’identification d’une classe de schéma par IID de l’interface principale du code de classe permet d’utiliser QueryInterface au moment de l’exécution pour déterminer si un objet appartient à la classe souhaitée.

Type d'accès : Lecture seule

Type de données de script : BSTR

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

Exemples

L’exemple de code suivant montre comment utiliser l’interface IADsClass pour déterminer si un objet peut être un conteneur et, le cas échéant, répertorie les noms des objets contenus.

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

L’exemple de code suivant montre comment utiliser l’interface IADsClass pour déterminer si un objet peut être un conteneur et, le cas échéant, répertorie les noms des objets contenus.

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

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista
Serveur minimal pris en charge
 Windows Server 2008
En-tête
Iads.h
DLL
Activeds.dll
IID
 IID_IADsClass est défini comme C8F93DD0-4AE0-11CF-9E73-00AA004A5691

Voir aussi

IADsClass

IADsClass::Qualificateurs