IADsCollection 인터페이스(iads.h)

아티클
08/24/2023

IADsCollection 인터페이스는 호스팅 ADSI 개체가 디렉터리 서비스에 대해 임의의 명명된 데이터 요소 집합을 정의하고 관리할 수 있게 해주는 이중 인터페이스입니다. 컬렉션은 전체 배열의 순서를 다시 지정하지 않고 개별 항목을 추가하거나 삭제할 수 있는 요소의 배열과 다릅니다.

컬렉션 개체는 프로세스 또는 활성 통신 세션과 같은 휘발성 데이터와 디렉터리 서비스의 실제 엔터티와 같은 영구 데이터에 해당하는 하나 이상의 항목을 나타낼 수 있습니다. 예를 들어 컬렉션 개체는 큐의 인쇄 작업 목록 또는 서버에 연결된 활성 세션 목록을 나타낼 수 있습니다. 컬렉션 개체는 임의의 데이터 집합을 나타낼 수 있지만 컬렉션의 모든 요소는 동일한 형식이어야 합니다. 데이터는 Variant 형식입니다.

또한 ADSI는 두 가지 특별한 컬렉션 개체 사례를 조작하기 위해 IADsMembers 및 IADsContainer 인터페이스를 노출합니다. IADsMembers 는 공통 멤버 자격을 공유하는 개체 컬렉션에 사용됩니다. 이러한 개체의 예로는 그룹에 속한 사용자가 있습니다. IADsContainer 는 다른 개체를 포함하는 ADSI 개체에 적용됩니다. 이 예제는 디렉터리 트리 또는 네트워크 토폴로지입니다.

상속

IADsCollection 인터페이스는 IDispatch 인터페이스에서 상속됩니다. IADsCollection 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IADsCollection 인터페이스에는 이러한 메서드가 있습니다.


IADsCollection::Add 컬렉션에 명명된 항목을 추가합니다.
IADsCollection::get__NewEnum IADsCollection::get__NewEnum 메서드는 이 ADSI 컬렉션 개체에 대해 IEnumVARIANT를 구현하는 종속 열거자 개체를 가져옵니다. 함수 이름(get__NewEnum)에는 두 개의 밑줄 문자가 있습니다.
IADsCollection::GetObject 컬렉션의 항목을 검색합니다.
IADsCollection::Remove IADsCollection::Remove 메서드는 이 ADSI 컬렉션 개체에서 명명된 항목을 제거합니다.