StgIsStorageFile 函数 (coml2api.h)

StgIsStorageFile 函数指示特定磁盘文件是否包含存储对象。

语法

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

[in] pwcsName

指向要检查的磁盘文件的以 null 结尾的 Unicode 字符串名称的指针。 pwcsName 参数未解释传递到基础文件系统。

StgIsStorageFile 函数还可以返回任何文件系统错误或 包装在 HRESULT 中的系统错误。请参阅错误处理策略和处理未知错误

存储对象基础磁盘文件的开头是一个签名，用于区分存储对象与其他文件格式。 StgIsStorageFile 函数对于其文档使用磁盘文件格式（可能使用或不使用存储对象）的应用程序非常有用。

如果已在事务处理模式下创建根复合文件，但尚未提交，此方法仍返回S_OK。