Metodi di proprietà IADsGroup

I metodi delle proprietà dell'interfaccia IADsGroup leggono e scrivono le proprietà seguenti. Per altre informazioni, vedere Metodi di proprietà dell'interfaccia.

Proprietà

Descrizione

Indica la descrizione testuale dell'appartenenza al gruppo.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Commenti

Uso di IADsGroup per recuperare le descrizioni dei gruppi predefiniti

Gli esempi seguenti illustrano come recuperare informazioni sugli oggetti gruppo di Windows in base al nome. In un ambiente multilingue, i gruppi predefiniti sono talvolta noti da nomi localizzati diversi, il che significa che non possono essere recuperati direttamente usando identificatori di stringa come "WinNT://Microsoft/Administrators". In tal caso, l'utente può associare all'oggetto SID noto per il gruppo, recuperare il nome del gruppo localizzato e specificare che al metodo GetObject. Per altre informazioni, vedere SID noti.

Esempio

Nell'esempio di Visual Basic seguente viene illustrato come associare a un oggetto gruppo e visualizzare la descrizione del gruppo.

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

Nell'esempio C++ seguente viene illustrato come associare a un oggetto gruppo e visualizzare la descrizione del gruppo.

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;

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Iads.h
DLL	Activeds.dll
IID	IID_IADsGroup è definito come 27636B00-410F-11CF-B1FF-02608C9E7553

Vedi anche

ID

IADsGroup

Metodi di proprietà Interface