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

Метод IByteBuffer::Stat

  • Статья

[Метод Stat доступен для использования в операционных системах, указанных в разделе Требования. Он недоступен для использования в 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
Заголовок
Scardssp.h
Библиотека типов
Scardssp.tlb
DLL
Scardssp.dll
IID
 IID_IByteBuffer определяется как E126F8FE-A7AF-11D0-B88A-00C04FD424B9