Метод IFunctionInstance::GetID (functiondiscoveryapi.h)

[Функция обнаружения доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Возвращает строку идентификатора для экземпляра функции. Этот идентификатор можно сохранить, а затем использовать для повторного запроса того же экземпляра функции через IFunctionDiscovery::GetInstance.

Синтаксис

HRESULT GetID(
  [out] WCHAR **ppszCoMemIdentity
);

Параметры

[out] ppszCoMemIdentity

Строка идентификатора экземпляра функции. Верхний предел размера этой строки отсутствует.

Эта строка представляет собой составную строку, созданную при обнаружении функций. Он содержит строку идентификатора экземпляра поставщика в качестве подстроки. Дополнительные сведения об идентификаторах поставщиков см. в разделе IFunctionInstance::GetProviderInstanceID.

Для экземпляров функций, возвращаемых встроенным поставщиком, этот идентификатор гарантированно однозначно идентифицирует ресурс в системе, даже если ресурс отключен и повторно подключен. Для экземпляров функций, возвращаемых пользовательскими поставщиками, идентификатор экземпляра функции является уникальным, если поставщик имеет уникальный идентификатор поставщика.

Этот идентификатор не должен обрабатываться или производиться программным способом. Строка должна использоваться только для получения экземпляров функций и для сравнения.

Не забудьте освободить этот буфер с помощью CoTaskMemFree.

Возвращаемое значение

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата	Описание
S_OK	Метод завершился успешно.
E_INVALIDARG	Недопустимое значение ppszCoMemID .
E_OUTOFMEMORY	Метод не может выделить память, необходимую для выполнения этой операции.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	functiondiscoveryapi.h
DLL	FunDisc.dll

См. также раздел

IFunctionInstance