Метод ILockBytes::Stat (objidl.h)

Статья
08/25/2023

Метод Stat извлекает структуру STATSTG , содержащую сведения для этого объекта массива байтов.

Синтаксис

HRESULT Stat(
  [out] STATSTG *pstatstg,
  [in]  DWORD   grfStatFlag
);

Параметры

[out] pstatstg

Указатель на структуру STATSTG , в которой этот метод помещает сведения об этом объекте массива байтов. Если возникает ошибка, указатель имеет значение NULL .

[in] grfStatFlag

Указывает, должен ли этот метод предоставлять член pwcsName структуры STATSTG через значения, взятые из перечисления STATFLAG . Если указан STATFLAG_NONAME, член pwcsNameSTATSTG не предоставляется, что позволяет сохранить операцию выделения памяти. Другое возможное значение, STATFLAG_DEFAULT, указывает, что должны быть предоставлены все члены структуры STATSTG .

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

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Структура STATSTG была успешно возвращена в указанном расположении.
E_OUTOFMEMORY	Структура STATSTG не была возвращена из-за нехватки памяти для элемента имени в структуре.
STG_E_ACCESSDENIED	Структура STATSTG не была возвращена, так как вызывающий объект не имеет доступа к массиву байтов.
STG_E_INSUFFICIENTMEMORY	Структура STATSTG не была возвращена из-за нехватки памяти.
STG_E_INVALIDFLAG	Недопустимое значение параметра grfStateFlag.
STG_E_INVALIDPOINTER	Недопустимое значение параметра pStatStg.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	objidl.h
Библиотека	Uuid.lib
DLL	Ole32.dll

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

ILockBytes — реализация File-Based

ILockBytes — реализация глобальной памяти

STATFLAG

STATSTG