Метод ILockBytes::Stat (objidl.h)
Метод 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. |
Комментарии
ILockBytes::Stat должен предоставлять сведения об объекте массива байтов в структуре STATSTG .
Требования
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | objidl.h |
| Библиотека | Uuid.lib |
| DLL | Ole32.dll |
См. также раздел
ILockBytes — реализация File-Based