IADsGroup：：Remove 方法 (iads.h)

發行項
08/24/2023

IADsGroup：：Remove方法會從此群組中移除指定的使用者物件。即使群組中沒有剩餘的成員，作業也不會移除群組物件本身。

語法

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

參數

[in] bstrItemToBeRemoved

包含 BSTR ，指定要從群組中移除之物件的 ADsPath。如需此參數的詳細資訊，請參閱一節。

傳回值

以下是最常見的傳回值。如需傳回值的詳細資訊，請參閱 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();