Partager via


IADsGroup, méthodes de propriété

Les méthodes de propriété de l’interface IADsGroup lisent et écrivent les propriétés suivantes. Pour plus d’informations, consultez Méthodes de propriété d’interface.

Propriétés

Description

Indique la description textuelle de l’appartenance au groupe.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

// C++ method syntax
HRESULT get_Description(
  [out] BSTR* pbstrDescription
);
HRESULT put_Description(
  [in] BSTR bstrDescription
);

Notes

Utilisation d’IADsGroup pour récupérer des descriptions de groupes intégrés

Les exemples suivants montrent comment récupérer des informations sur les objets de groupe Windows par nom. Dans un environnement multilingue, les groupes intégrés sont parfois connus par différents noms localisés, ce qui signifie qu’ils ne peuvent pas être récupérés directement à l’aide d’identificateurs de chaîne tels que « WinNT://Microsoft/Administrators ». Dans ce cas, l’utilisateur peut établir une liaison à l’objet SID bien connu pour le groupe, récupérer le nom du groupe localisé et le fournir à la méthode GetObject. Pour plus d’informations, consultez Sids connus.

Exemples

L’exemple Visual Basic suivant montre comment établir une liaison à un objet de groupe et afficher la description du groupe.

Dim grp As IADsGroup
On Error GoTo Cleanup

Set grp = GetObject("WinNT://Microsoft/Administrators")
Debug.Print grp.Description

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

L’exemple C++ suivant montre comment lier à un objet de groupe et afficher la description du groupe.

IADsGroup *pGroup = NULL;
HRESULT hr = S_OK;
LPWSTR adsPath = L"WinNT://localHost/Administrators";
BSTR bstr;

hr = ADsGetObject(adsPath,IID_IADsGroup,(void**)&pGroup);

if(FAILED(hr)) {goto Cleanup;}

hr = pGroup->get_Description(&bstr);
if(FAILED(hr)) {goto Cleanup;}

printf("Description: %S\n",bstr);

Cleanup:
    SysFreeString(bstr);
    if(pGroup) 
        pGroup->Release();

    return hr;

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_IADsGroup est défini comme 27636B00-410F-11CF-B1FF-02608C9E7553

Voir aussi

IADs

IADsGroup

Méthodes de propriété d’interface