Метод IByteBuffer::Stat
[Метод Stat доступен для использования в операционных системах, указанных в разделе Requirements. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версий, Windows Vista, Windows Server 2008 и последующих версий операционной системы. Интерфейс IStream обеспечивает аналогичную функциональность.]
Метод Stat извлекает статистическую информацию из объекта потока.
Синтаксис
HRESULT Stat(
[out] LPSTATSTRUCT pstatstg,
[in] LONG grfStatFlag
);
Параметры
-
pstatstg [out]
-
Указывает на структуру STATSTRUCT , в которой этот метод помещает сведения об этом объекте потока. Этот указатель имеет значение NULL , если возникает ошибка.
-
grfStatFlag [in]
-
Указывает, что этот метод не возвращает некоторые поля в структуре STATSTRUCT , тем самым сохраняя операцию выделения памяти. Значения взяты из перечисления STATFLAG
Возвращаемое значение
Возвращаемое значение — HRESULT. Значение S_OK указывает, что вызов выполнен успешно.
Комментарии
Метод IByteBuffer::Stat извлекает указатель на структуру STATSTRUCT , содержащую сведения об этом открытом потоке.
Примеры
В следующем примере показано получение статистических сведений из потока.
STATSTRUCT statstr;
HRESULT hr;
// Retrieve the statistical information.
hr = pIByteBuff->Stat(&statstr,
STATFLAG_DEFAULT);
if (FAILED(hr))
printf("Failed IByteBuffer::Stat\n");
else
// Use statstr as needed.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows XP [только классические приложения] |
Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
Прекращение поддержки клиентов |
Windows XP |
Прекращение поддержки сервера |
Windows Server 2003 |
Заголовок |
|
Библиотека типов |
|
DLL |
|
IID |
IID_IByteBuffer определяется как E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |