[함수 검색은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
함수 instance 대한 식별자 문자열을 가져옵니다. 이 식별자를 저장하고 나중에 IFunctionDiscovery::GetInstance를 통해 instance 동일한 함수를 다시 쿼리하는 데 사용할 수 있습니다.
구문
HRESULT GetID(
[out] WCHAR **ppszCoMemIdentity
);
매개 변수
[out] ppszCoMemIdentity
식별자 문자열을 instance 함수입니다. 이 문자열의 크기에 대한 상한은 없습니다.
이 문자열은 함수 검색에서 생성된 구성된 문자열입니다. 공급자 instance 식별자 문자열을 부분 문자열로 사용합니다. 공급자 식별자에 대한 자세한 내용은 IFunctionInstance::GetProviderInstanceID를 참조하세요.
기본 제공 공급자가 반환하는 함수 인스턴스의 경우 이 식별자는 리소스의 연결이 끊어지고 다시 연결되더라도 시스템의 리소스를 고유하게 식별하도록 보장됩니다. 사용자 지정 공급자가 반환하는 함수 인스턴스의 경우 공급자에 고유한 공급자 식별자가 있는 경우 함수 instance 식별자는 고유합니다.
이 식별자는 프로그래밍 방식으로 조작하거나 제조해서는 안 됩니다. 문자열은 함수 인스턴스를 검색하고 비교 목적으로만 사용해야 합니다.
CoTaskMemFree를 사용하여 이 버퍼를 해제해야 합니다.
반환 값
가능한 반환 값은 다음을 포함하지만 이에 국한되지 않습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
ppszCoMemID 값이 잘못되었습니다. |
|
메서드는 이 작업을 수행하는 데 필요한 메모리를 할당할 수 없습니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | functiondiscoveryapi.h |
| DLL | FunDisc.dll |