IADsGroup::Add-Methode (iads.h)

Artikel
08/24/2023

Die IADsGroup::Add-Methode fügt einer vorhandenen Gruppe ein ADSI-Objekt hinzu.

Syntax

HRESULT Add(
  [in] BSTR bstrNewItem
);

Parameter

[in] bstrNewItem

Enthält einen BSTR , der den ADsPath des Objekts angibt, das der Gruppe hinzugefügt werden soll. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Im Folgenden finden Sie die häufigsten Rückgabewerte. Weitere Informationen zu Rückgabewerten finden Sie unter ADSI-Fehlercodes.

Hinweise

Wenn der LDAP-Anbieter zum Binden an das IADsGroup-Objekt verwendet wird, muss die gleiche Form von ADsPath im bstrNewItem-Parameter angegeben werden. Wenn der zum Binden an das IADsGroup-Objekt verwendete ADsPath beispielsweise einen Server enthält, muss der ADsPath im bstrNewItem-Parameter das gleiche Serverpräfix enthalten. Wenn ein serverloser Pfad zum Binden an das IADsGroup-Objekt verwendet wird, muss der bstrNewItem-Parameter ebenfalls einen serverlosen Pfad enthalten. Bei Verwendung des Serverpräfixes können Verzögerungen auftreten, wenn die Gruppe und das neue Mitglied aus unterschiedlichen Domänen stammen, da Anforderungen möglicherweise an den falschen Domänencontroller gesendet und auf einen Domänencontroller der richtigen Domäne verwiesen und dort wiederholt werden. Eine Ausnahme tritt auf, wenn ein Mitglied mithilfe einer GUID oder einer SICHERHEITS-ID (SID) ADsPath hinzugefügt oder entfernt wird. In diesem Fall sollte immer ein serverloser Pfad in bstrNewItem verwendet werden.

Der LDAP-Anbieter für Active Directory ermöglicht das Hinzufügen eines Mitglieds zu einer Gruppe mithilfe der Zeichenfolgenform der Member-SID. Der bstrNewItem-Parameter kann eine SID-Zeichenfolge im folgenden Format enthalten.

LDAP://SID=<010500000000000515000000c6bb507afbda8b7f43170a325b040000>

Weitere Informationen zu SID-Zeichenfolgen in Active Directory finden Sie unter Binden an ein Objekt mithilfe einer SID.

Der WinNT-Anbieter für Active Directory ermöglicht auch das Hinzufügen eines Mitglieds zu einer Gruppe mithilfe der Zeichenfolgenform der SID des Mitglieds. Der bstrNewItem-Parameter kann eine SID-Zeichenfolge im folgenden Format enthalten.

WinNT://S-1-5-21-35135249072896"

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie der Gruppe ("Administratoren") in der Domäne "Fabrikam" mithilfe des WinNT-Anbieters ein Benutzerobjekt ("jeff") hinzufügen.

Dim grp As IADsGroup
Set grp = GetObject("WinNT://Fabrikam/Administrators")
grp.Add ("WinNT://Fabrikam/jeff")

Im folgenden Codebeispiel wird gezeigt, wie Sie einer Gruppe mithilfe des LDAP-Anbieters ein Benutzerobjekt hinzufügen.

Dim grp As IADsGroup
On Error GoTo Cleanup

Set grp = GetObject("LDAP://CN=Administrators, CN=Users, DC=Fabrikam, DC=com")
grp.Add("LDAP://CN=Jeff Smith, OU=Sales,DC=Fabrikam,DC=com")

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set grp = Nothing

Im folgenden Codebeispiel wird der Gruppe Administratoren ein vorhandenes Benutzerkonto hinzugefügt.

IADsGroup *pGroup = NULL;
HRESULT hr = S_OK;
LPWSTR adsPath = L"WinNT://Fabrikam/Administrators";
hr = ADsGetObject(adsPath,IID_IADsGroup,(void**)&pGroup);
if(FAILED(hr)) {goto Cleanup;}

// This assumes that the "WinNT://Fabrikam/jeff" user account exists 
// and does not already belong to the Administrators group.

hr = pGroup->Add(_bstr_t("WinNT://Fabrikam/jeff"));
if(FAILED(hr)){goto Cleanup;}

Cleanup:
    if(pGroup)
        pGroup->Release();

    return hr;

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll