StgIsStorageFile

Indicates whether a particular disk file contains a storage object.

HRESULT StgIsStorageFile(

const WCHAR * pwcsName	//Points to a pathname of the file to check
);

Parameter
pwcsName

Points to the name of the disk file to be examined. The pwcsName parameter is passed uninterpreted to the underlying file system.

Return Values
S_OK

Indicates the file contains a storage object.

S_FALSE

Indicates the file does not contain a storage object.

STG_E_INVALIDFILENAME

Indicates a bad filename was passed in the pwcsName parameter.

STG_E_FILENOTFOUND

Indicates the pwcsName parameter could not be determined.

See also any file system errors for other error return values.

Comments
At the beginning of the disk file underlying a storage object is a signature distinguishing a storage object from other file formats. The StgIsStorageFile function is useful to applications whose documents use a disk file format that might or might not use storage objects.