IADsGroup-Eigenschaftenmethoden

Die Eigenschaftenmethoden der IADsGroup-Schnittstelle lesen und schreiben die folgenden Eigenschaften. Weitere Informationen finden Sie unter Schnittstelleneigenschaftsmethoden.

Eigenschaften

Beschreibung

Gibt die Textbeschreibung der Gruppenmitgliedschaft an.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

Hinweise

Verwenden von IADsGroup zum Abrufen von Beschreibungen integrierter Gruppen

In den folgenden Beispielen wird gezeigt, wie Sie Informationen zu Windows nach Namen gruppieren. In einer mehrsprachigen Umgebung sind integrierte Gruppen manchmal durch verschiedene lokalisierte Namen bekannt, was bedeutet, dass sie nicht direkt mithilfe von Zeichenfolgenbezeichnern wie "WinNT://Microsoft/Administrators" abgerufen werden können. In diesem Fall kann der Benutzer eine Bindung an das bekannte SID-Objekt für die Gruppe erstellen, den lokalisierten Gruppennamen abrufen und an die GetObject-Methode angeben. Weitere Informationen finden Sie unter Bekannte SIDs.

Beispiele

Das folgende Visual Basic zeigt, wie eine Bindung an ein Gruppenobjekt erstellt und die Beschreibung der Gruppe angezeigt wird.

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

Im folgenden C++-Beispiel wird veranschaulicht, wie eine Bindung an ein Gruppenobjekt erstellt und die Beschreibung der Gruppe angezeigt wird.

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;

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Header
Iads.h
DLL
Activeds.dll
IID
IID _ IADsGroup ist als 27636B00-410F-11CF-B1FF-02608C9E7553 definiert.

Siehe auch

Iads

IADsGroup

Schnittstelleneigenschaftsmethoden