Methoden der IADsGroup-Eigenschaft

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

Eigenschaften

Beschreibung

Gibt die Textbeschreibung der Gruppenmitgliedschaft an.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

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

Bemerkungen

Verwenden von IADsGroup zum Abrufen von Beschreibungen integrierter Gruppen

Die folgenden Beispiele zeigen, wie Sie Informationen zu Windows-Gruppenobjekten nach Name abrufen. 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 herstellen, den lokalisierten Gruppennamen abrufen und diesen an die GetObject-Methode bereitstellen. Weitere Informationen finden Sie unter Bekannte SIDs.

Beispiele

Das folgende Visual Basic-Beispiel zeigt, wie sie an ein Gruppenobjekt gebunden und die Beschreibung der Gruppe angezeigt werden.

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

Das folgende C++-Beispiel zeigt, wie sie an ein Gruppenobjekt gebunden werden und wie 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

Siehe auch

Iads

IADsGroup

Methoden der Schnittstelleneigenschaft