Метод IStream::Stat (objidl.h)
Метод Stat извлекает структуру STATSTG для этого потока.
Синтаксис
HRESULT Stat(
[out] STATSTG *pstatstg,
[in] DWORD grfStatFlag
);
Параметры
[out] pstatstg
Указатель на структуру STATSTG , в которой этот метод помещает сведения об этом объекте потока.
[in] grfStatFlag
Указывает, что этот метод не возвращает некоторые элементы в структуре STATSTG , тем самым сохраняя операцию выделения памяти. Значения взяты из перечисления STATFLAG .
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
| S_OK | Структура STATSTG была успешно возвращена в указанном расположении. |
| E_PENDING | Только асинхронное хранилище. Часть или все данные потока в настоящее время недоступны. |
| STG_E_ACCESSDENIED | Вызывающий объект не имеет достаточных разрешений для доступа к статистике для этого объекта хранилища. |
| STG_E_INSUFFICIENTMEMORY | Структура STATSTG не была возвращена из-за нехватки памяти. |
| STG_E_INVALIDFLAG | Недопустимое значение параметра grfStateFlag . |
| STG_E_INVALIDPOINTER | Недопустимый указатель pStatStg . |
| STG_E_REVERTED | Объект был признан недействительным операцией отменить изменения над ним в дереве транзакций. |
Комментарии
IStream::Stat получает указатель на структуру STATSTG , содержащую сведения об этом открытом потоке. Когда этот поток находится в структурированном хранилище и вызывается IStorage::EnumElements , он создает объект перечислителя с интерфейсом IEnumSTATSTG , который можно вызвать для перечисления хранилищ и потоков через структуры STATSTG , связанные с каждым из них.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | objidl.h |
| Библиотека | Uuid.lib |
| DLL | Ole32.dll |