Метод Ибитебуффер:: stat

• 05/31/2018
• Чтение занимает 2 мин
• • l
  • o

[Метод stat доступен для использования в операционных системах, указанных в разделе требования. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздней версии, Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Интерфейс IStream предоставляет аналогичные функциональные возможности.]

Метод stat получает статистические данные из объекта потока.

Синтаксис

HRESULT Stat(
  [out] LPSTATSTRUCT pstatstg,
  [in]  LONG         grfStatFlag
);

Параметры

пстатстг [ заполняет]

Указывает на структуру статструкт , в которой этот метод помещает сведения об этом объекте потока. При возникновении ошибки этот указатель имеет значение NULL .

грфстатфлаг [ окне]

Указывает, что этот метод не возвращает некоторые поля в структуре статструкт , тем самым сохраняя операцию выделения памяти. Значения берутся из перечисления статфлаг

Возвращаемое значение

Возвращаемое значение является значением HRESULT. Значение S _ ОК указывает на Успешный вызов.

Комментарии

Метод ибитебуффер:: stat получает указатель на структуру статструкт , содержащую сведения об этом открытом потоке.

Примеры

В следующем примере показано получение статистических данных из потока.

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.

Требования