Метод IDebugHostModule::GetVersion (dbgmodel.h)

  • Статья

Метод GetVersion возвращает сведения о версии модуля (при условии, что такие сведения могут быть успешно считаны из заголовков). Если запрашивается заданная версия (с помощью указателя вывода, отличного от nullptr), и она не может быть прочитана, из вызова метода будет возвращен соответствующий код ошибки.

Синтаксис

HRESULT GetVersion(
  ULONG64 *fileVersion,
  ULONG64 *productVersion
);

Параметры

fileVersion

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

productVersion

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

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

Этот метод возвращает HRESULT, который указывает на успех или сбой.

Комментарии

Образец кода

ComPtr<IDebugHostModule> spModule; /* get a module (see FindModuleByName) */

ULONG64 fileVersion;
ULONG64 productVersion;
if (SUCCEEDED(spModule->GetVersion(&fileVersion, &productVersion)))
{
    // fileVersion contains a.b.c.d (16.16.16.16) file version
    // productVersion contains a.b.c.d (16.16.16.16) product version
}

Требования

Требование Значение
Заголовок dbgmodel.h

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

Интерфейс IDebugHostModule