IADsExtension 인터페이스(iads.h)

IADsExtension 인터페이스는 ADSI 애플리케이션 확장 모델의 기초를 형성합니다. ISV(독립 소프트웨어 공급업체)가 메서드 또는 함수와 같은 애플리케이션별 동작을 기존 ADSI 개체에 추가할 수 있습니다. 여러 공급업체는 동일 개체의 기능을 독립적으로 확장하여 유사하지만 관련이 없는 작업을 수행할 수 있습니다.

확장 모델은 COM의 집계 모델을 기반으로 합니다. 집계자 또는 외부 개체는 메서드, 집계 개체 또는 내부 개체의 기본에 추가할 수 있습니다. IADsExtension 인터페이스를 구현하는 ADSI 확장 개체는 집계 개체인 반면 ADSI 공급자는 집계자입니다.

참고 확장 모듈을 구현할 때 완료된 인터페이스를 해제합니다. 그렇지 않으면 집계자는 더 이상 필요하지 않은 경우에도 인터페이스를 해제할 수 없습니다.

 

IADsExtension 인터페이스는 다음과 같이 사용할 수 있습니다.

• 확장 구성 요소에는 Operate 메서드의 dwCode에 정의된 초기화 알림이 필요합니다. 이 경우 확장 클라이언트는 Operate 메서드를 호출해야 합니다. 다른 두 메서드, 즉 PrivateInvoke 및 PrivateGetIDsOfNames는 일반적으로 HRESULT 값에 E_NOTIMPL 반환합니다.
• 확장 구성 요소는 모든 이중 또는 디스패치 인터페이스를 지원합니다. 이 경우 확장 클라이언트는 PrivateGetIDsOfNames 또는 PrivateInvoke 메서드를 호출해야 합니다. 일반적으로 연동은 데이터를 무시하고 HRESULT 값에 E_NOTIMPL 반환합니다.

상속

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

메서드

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

IADsExtension::Operate 공급자의 사양에 따라 컨트롤 코드 및 입력 매개 변수를 해석합니다.
IADsExtension::P rivateGetIDsOfNames IADsExtension::P rivateGetIDsOfNames 메서드는 ADSI가 확장이 이중 또는 디스패치 인터페이스를 지원하는 데 사용됨을 확인한 후 집계자 ADSI에 의해 호출됩니다. 메서드는 형식 데이터를 사용하여 IDispatch::GetIDsOfNames를 사용하여 DISPID를 가져올 수 있습니다.
IADsExtension::P rivateInvoke IADsExtension::P rivateInvoke 메서드는 일반적으로 IADsExtension::P rivateGetIDsOfNames 메서드 다음에 ADSI에서 호출됩니다. 이 메서드는 사용자 지정 구현을 포함하거나 작업을 IDispatch::D ispInvoke 메서드에 위임할 수 있습니다.

요구 사항

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