[함수 검색은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
함수 검색 공급자 개체를 초기화합니다. 이 메서드는 개체를 만든 직후 호출할 수 있습니다.
구문
HRESULT Initialize(
[in] IFunctionDiscoveryProviderFactory *pIFunctionDiscoveryProviderFactory,
[in] IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
[in] LCID lcidUserDefault,
[out] DWORD *pdwStgAccessCapabilities
);
매개 변수
[in] pIFunctionDiscoveryProviderFactory
IFunctionDiscoveryProviderFactory 인터페이스에 대한 포인터입니다. 공급자는 이 인터페이스를 사용하여 새 함수 검색 개체를 만들어야 합니다.
[in] pIFunctionDiscoveryNotification
IFunctionDiscoveryNotification 인터페이스에 대한 포인터입니다. 공급자는 이 인터페이스를 사용하여 OnUpdate, OnEvent 및 OnError 알림을 함수 검색 알림 큐로 보내야 합니다. 대기 중인 알림은 함수 검색을 통해 클라이언트 프로그램으로 전송됩니다.
[in] lcidUserDefault
호출자의 로캘 식별자입니다. 공급자는 lcidUserDefault 를 사용하여 공급자가 열거한 리소스에 대해 지역화된 문자열을 반환해야 합니다.
[out] pdwStgAccessCapabilities
이 공급자가 만든 함수 인스턴스와 연결된 속성 저장소의 가장 제한적인 액세스 모드를 지정합니다.
DWORD 값이 -1로 설정된 경우 이 공급자가 만든 함수 instance OpenPropertyStore가 호출될 때마다 InstancePropertyStoreValidateAccess가 호출됩니다. 그렇지 않으면 이 매개 변수에 지정된 값은 이 공급자가 만든 모든 함수 인스턴스와 연결된 모든 속성 저장소에 대해 가능한 가장 제한적인 액세스 모드를 결정합니다. 클라이언트가 dwStgAccess 매개 변수가 지정된 pdwStgAccessCapabilities 값보다 더 제한적인 값으로 설정된 OpenPropertyStore를 호출하는 경우 개별 속성 저장소에 더 제한적인 액세스 모드가 적용됩니다.
효율성을 위해 가능하면 pdwStgAccessCapabilities 값을 지정합니다.
지원되는 모드는 다음과 같습니다.
STGM_READ
STGM_READWRITE
STGM_WRITE
반환 값
가능한 반환 값은 다음을 포함하지만 이에 국한되지 않습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
매개 변수 중 하나에 잘못된 인수가 포함되어 있습니다. |
설명
공급자가 지역화된 문자열을 사용하여 함수 검색 개체, 큐 알림 또는 리소스를 열거하려는 경우 에서 AddRef를 호출하고 Initialize 메서드를 구현할 때 나중에 사용할 수 있도록 초기화된 pIFunctionDiscoveryProviderFactory, pIFunctionDiscoveryNotification 및 lcidUserDefault 매개 변수를 캐시해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | functiondiscoveryprovider.h |