IADsGroup-Eigenschaftenmethoden
Die Eigenschaftenmethoden der IADsGroup-Schnittstelle lesen und schreiben die folgenden Eigenschaften. Weitere Informationen finden Sie unter Schnittstelleneigenschaftsmethoden.
Eigenschaften
-
Beschreibung
-
-
Zugriffstyp: Lesen/Schreiben
-
Skriptdatentyp: BSTR
-
// C++ method syntax HRESULT get_Description( [out] BSTR* pbstrDescription ); HRESULT put_Description( [in] BSTR bstrDescription );
Gibt die Textbeschreibung der Gruppenmitgliedschaft an.
-
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 |
|
| DLL |
|
| IID |
IID _ IADsGroup ist als 27636B00-410F-11CF-B1FF-02608C9E7553 definiert. |