IADsGroup, méthodes de propriété

Article
06/12/2023

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

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

Partager via