IFunctionDiscovery::GetInstance 메서드(functiondiscoveryapi.h)

[Function Discovery는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

식별자를 기반으로 지정된 함수 instance 가져옵니다.

구문

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

매개 변수

[in] pszFunctionInstanceIdentity

함수 instance 식별자입니다(GetID 참조).

[out] ppIFunctionInstance

인터페이스를 반환하는 데 사용되는 IFunctionInstance 인터페이스 포인터에 대한 포인터입니다.

반환 값

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드/값	Description
S_OK	메서드가 완료되었습니다.
E_INVALIDARG	pszFunctionInstanceIdentity 값이 잘못되었습니다.
E_OUTOFMEMORY	메서드는 이 작업을 수행하는 데 필요한 메모리를 할당할 수 없습니다.
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND) 0x800710d8	지정된 ID로 표시되는 함수 instance 이 컴퓨터에 없습니다.
E_PENDING	결과를 비동기적으로 반환하는 공급자에 대해 호출이 실행되었습니다.

설명

일부 함수 검색 공급자는 IFunctionDiscoveryNotification 인터페이스를 사용하여 쿼리 결과를 반환합니다. GetInstance 는 이러한 방식으로 반환되는 함수 인스턴스를 찾지 못하며 E_PENDING 실패합니다. 클라이언트는 IFunctionDiscovery 인터페이스의 CreateInstanceQuery 메서드를 사용하여 이러한 공급자에 대한 함수 인스턴스를 찾는 것이 좋습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	functiondiscoveryapi.h
DLL	FunDisc.dll

추가 정보

IFunctionDiscovery