Поделиться через

Метод IOleUIObjInfoW::GetObjectInfo (oledlg.h)

  • Статья

Возвращает сведения о размере, типе, имени и расположении объекта.

Синтаксис

HRESULT GetObjectInfo(
  [in]            DWORD  dwObject,
  [out]           DWORD  *lpdwObjSize,
  [out, optional] LPWSTR *lplpszLabel,
  [out, optional] LPWSTR *lplpszType,
  [out, optional] LPWSTR *lplpszShortType,
  [out, optional] LPWSTR *lplpszLocation
);

Параметры

[in] dwObject

Уникальный идентификатор объекта.

[out] lpdwObjSize

Указатель на размер объекта (в байтах) на диске. Это может быть приблизительное значение.

[out, optional] lplpszLabel

Адрес переменной указателя, получающей указатель на строку метки объекта. Этот параметр может иметь значение NULL , чтобы указать, что реализация не должна возвращать строку метки.

[out, optional] lplpszType

Адрес переменной указателя, получающей указатель на строку длинного типа объекта. Этот параметр может иметь значение NULL , чтобы указать, что реализация не должна возвращать строку длинного типа.

[out, optional] lplpszShortType

Адрес переменной указателя, получающей указатель на строку короткого типа объекта. Этот параметр может иметь значение NULL , чтобы указать, что реализация не должна возвращать строку короткого типа.

[out, optional] lplpszLocation

Адрес переменной указателя, получающей указатель на строку исходного расположения объекта. Этот параметр может иметь значение NULL , чтобы указать, что реализация не должна возвращать строку расположения.

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

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

Код возврата Описание
E_FAIL
 Операция не удалась.
E_INVALIDARG
 Указанный идентификатор недопустим.
E_OUTOFMEMORY
 Для этой операции недостаточно памяти.

Комментарии

Строки и размер объекта отображаются на странице свойств объекта Общие .

Примечания для разработчиков

Реализация GetObjectInfo должна помещать каждый из атрибутов объекта в предоставленные параметры out. Присвойте lpdwObjSize значение (DWORD)-1, если размер объекта неизвестен. Выделите все строки (остальные параметры) с помощью распределителя задач OLE, полученного с помощью CoGetMalloc, как это стандартно для всех интерфейсов OLE с параметрами строки [out], или можно просто использовать CoTaskMemAlloc.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header oledlg.h

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

CoGetMalloc

CoTaskMemAlloc

IOleUIObjInfo