Methoden der IADsGroup-Eigenschaft

Artikel
06/12/2023

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

Eigenschaften

Beschreibung

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

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

Siehe auch

Iads
IADsGroup
Methoden der Schnittstelleneigenschaft

Freigeben über