[Function Discovery는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
함수 instance 만듭니다. 이 메서드를 사용하여 모든 함수 인스턴스를 만들어야 합니다. IFunctionInstance를 지원하는 다른 구현은 사용하지 않아야 합니다.
구문
HRESULT CreateInstance(
[in] const WCHAR *pszSubCategory,
[in] const WCHAR *pszProviderInstanceIdentity,
[in] INT_PTR iProviderInstanceContext,
[in] IPropertyStore *pIPropertyStore,
[in] IFunctionDiscoveryProvider *pIFunctionDiscoveryProvider,
[out] IFunctionInstance **ppIFunctionInstance
);
매개 변수
[in] pszSubCategory
함수 instance 대한 하위 범주 문자열입니다. 하위 범주 정의를 참조하세요.
[in] pszProviderInstanceIdentity
공급자 instance 식별자입니다.
Function Discovery는 이 식별자를 사용하여 IFunctionInstance::GetID에서 반환된 함수 instance 식별자가 고유하도록 합니다. 이를 위해 함수 검색은 pszProviderInstanceIdentity에 전달된 식별자에 접두사를 연결하여 지정된 함수 instance 식별자가 모든 공급자에서 고유하도록 합니다. 구현자는 pszProviderInstanceIdentity가 공급자의 scope 내에서 디바이스, 리소스 또는 instance 고유하게 식별하도록 하기만 하면 됩니다.
이 문자열은 IFunctionInstance::GetProviderInstanceID를 호출하는 클라이언트 애플리케이션에 반환됩니다.
이 문자열의 크기에는 상한이 없습니다.
[in] iProviderInstanceContext
특정 함수와 연결된 컨텍스트는 instance.
[in] pIPropertyStore
IPropertyStore 인터페이스에 대한 포인터입니다.
[in] pIFunctionDiscoveryProvider
이 함수를 만드는 instance IFunctionDiscoveryProvider 공급자에 대한 포인터 instance.
[out] ppIFunctionInstance
IFunctionInstance 인터페이스에 대한 포인터입니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
공급자는 하위 범주(NULL일 수 있음), instance 식별자, 공급자 할당 컨텍스트(필요한 경우) 및 선택적 속성 저장소를 지정해야 합니다.
CreateInstance는 공급자에 instance 적절하게 초기화된 함수를 반환합니다.
공급자가 지정한 컨텍스트는 InstanceReleased, InstancePropertyStoreOpen, InstancePropertyStoreFlush 및 InstanceQueryService와 같은 모든 후속 함수 instance 관련 메서드에 대해 공급자에게 다시 전달됩니다.
공급자는 CreateInstance가 호출되는 동안 공급자 참조 수가 다른 스레드에서 0으로 이동하지 않도록 보장해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | functiondiscoveryprovider.h |