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


Функция StgIsStorageFile (coml2api.h)

Функция StgIsStorageFile указывает, содержит ли конкретный файл диска объект хранилища.

Синтаксис

HRESULT StgIsStorageFile(
  [in] const WCHAR *pwcsName
);

Параметры

[in] pwcsName

Указатель на имя строки Юникода, завершаемой null, для проверяемого файла диска. Параметр pwcsName передается неинтерпретированным в базовую файловую систему.

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

Функция StgIsStorageFile также может возвращать любые ошибки файловой системы или системные ошибки, заключенные в HRESULT. См. статью Стратегии обработки ошибок и Обработка неизвестных ошибок.

Комментарии

В начале файла диска, лежащего в основе объекта хранилища, находится сигнатура, отличающая объект хранилища от других форматов файлов. Функция StgIsStorageFile полезна для приложений, документы которых используют формат файлов диска, который может использовать или не использовать объекты хранилища.

Если корневой составной файл был создан в режиме транзакций, но еще не зафиксирован, этот метод по-прежнему возвращает S_OK.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header coml2api.h (включая Objbase.h)
Библиотека Ole32.lib
DLL Ole32.dll

См. также раздел

StgIsStorageILockBytes