Метод IByteBuffer::Stat

  • Статья
  • Чтение занимает 2 мин

[Метод 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
Заголовок
Scardssp.h
Библиотека типов
Scardssp.tlb
DLL
Scardssp.dll
IID
 IID_IByteBuffer определяется как E126F8FE-A7AF-11D0-B88A-00C04FD424B9