다음을 통해 공유

IADsCollection::Remove 메서드(iads.h)

  • 아티클

IADsCollection::Remove 메서드는 이 ADSI 컬렉션 개체에서 명명된 항목을 제거합니다.

구문

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

매개 변수

[in] bstrItemToBeRemoved

IADsCollection::Add에서 지정한 대로 항목의 이름을 지정하는 null로 종료된 유니코드 문자열입니다.

반환 값

이 메서드는 S_OK 포함하여 표준 반환 값을 지원합니다. 자세한 내용 및 기타 반환 값은 ADSI 오류 코드를 참조하세요.

설명

디렉터리 서비스에 대한 컬렉션은 변경할 수 없는 개체 집합으로 구성됩니다.

항목의 직접 제거를 지원하지 않는 컬렉션은 E_NOTIMPL 반환해야 합니다.

예제

다음 Visual Basic 코드 예제에서는 활성 파일 서비스 세션 컬렉션에서 명명된 세션 개체를 제거하는 방법을 보여 줍니다.

Dim fso As IADsFileServiceOperations 
Dim ses As IADsSession
Dim coll As IADsCollection
Dim mySessionName As String

On Error GoTo Cleanup

Set fso = GetObject("WinNT://myComputer/FabrikamServer") 
Set coll = fso.Sessions

' Insert code to set mySessionName to the name of the mySession 
' session object.
 
' The following statement invokes IADsCollection::Remove.
coll.Remove mySessionName

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

다음 C++ 코드 예제에서는 활성 파일 서비스 세션 컬렉션에서 명명된 세션 개체를 제거하는 방법을 보여 줍니다.

HRESULT RemoveASessionObjectFromCollection()
{
    LPWSTR adspath = L"WinNT://myComputer/FabrikamServer";
    HRESULT hr = S_OK;
    IADsCollection *pColl = NULL;
    IADsFileServiceOperations *pFso = NULL;

    hr = ADsGetObject(adspath,IID_IADsFileServiceOperations,(void**)&pFso);
    if(FAILED(hr)) {goto Cleanup;}

    hr = pFso->Sessions(&pColl);
    if(FAILED(hr)) {goto Cleanup;}

    hr = pColl->Remove(CComBSTR("MySession"));

Cleanup
    if(pFso) pFso->Release();
    if(pColl) pColl->Release();

    return hr;
}

요구 사항

   
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 iads.h
DLL Activeds.dll

참고 항목

ADSI 오류 코드

IADsCollection

IADsCollection::Add