IADsGroup::Remove メソッド (iads.h)

IADsGroup::Remove メソッドは、指定したユーザー オブジェクトをこのグループから削除します。 この操作では、グループ内にメンバーが残っていない場合でも、グループ オブジェクト自体は削除されません。

構文

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

パラメーター

[in] bstrItemToBeRemoved

グループから削除するオブジェクトの ADsPath を指定する BSTR が含まれます。 このパラメーターの詳細については、「解説」セクションを参照してください。

戻り値

最も一般的な戻り値を次に示します。 戻り値の詳細については、「 ADSI エラー コード」を参照してください。

解説

LDAP プロバイダーを使用して IADsGroup オブジェクトにバインドする場合は、 bstrItemToBeRemoved パラメーターに同じ形式の ADsPath を指定する必要があります。 たとえば、 IADsGroup オブジェクトへのバインドに使用される ADsPath にサーバーが含まれている場合、 bstrItemToBeRemoved パラメーターの ADsPath には同じサーバー プレフィックスが含まれている必要があります。 同様に、サーバーレス パスを使用して IADsGroup オブジェクトにバインドする場合、 bstrItemToBeRemoved パラメーターにもサーバーレス パスが含まれている必要があります。 例外は、GUID または SID ADsPath を使用してメンバーを追加または削除する場合です。 この場合、サーバーレス パスは常に bstrItemToBeRemoved で使用する必要があります。

ADsPath の SID を使用して、WinNT プロバイダーを介してグループからセキュリティ プリンシパルを削除できます。 たとえば、ユーザー "Fabrikam\jeffsmith" の SID が S-1-5-21-35135249072896 であるとします。次のステートメントを示します。

Dim group As IADsGroup
group.Remove("WinNT://S-1-5-21-35135249072896")

上記の式は、次の式と同じです。

Dim group As IADsGroup
group.Remove("WinNT://Fabrikam/jeffsmith")

WinNT プロバイダーを介して SID を使用してメンバーを削除することは、Windows 2000 および DSCLIENT パッケージの新機能です。

例

次のコード例では、グループからユーザー アカウントを削除します。

Dim grp As IADsGroup
On Error GoTo Cleanup

Set grp = GetObject("WinNT://Fabrikam/Administrators")
grp.Remove ("WinNT://Fabrikam/jeffsmith")

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

次のコード例では、グループからユーザーを削除します。

IADsGroup *pGroup = NULL;
HRESULT hr = S_OK;
LPWSTR usrPath = L"WinNT://Fabrikam/jeffsmith";
LPWSTR grpPath = L"WinNT://Fabrikam/Administrators";

hr = ADsGetObject(grpPath, IID_IADsGroup, (void**)&pGroup);
if(FAILED(hr)){goto Cleanup;}

hr = pGroup->Remove(CComBSTR(usrPath));
if(FAILED(hr)){goto Cleanup;}

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

要件

関連項目

ADSI エラー コード

IADsGroup

IADsGroup プロパティ メソッド

IADsMembers