Edit

Share via

IFileSystemImage::Exists method (imapi2fs.h)

  • Article

Checks for the existence of a given file or directory.

Syntax

HRESULT Exists(
  [in]  BSTR        fullPath,
  [out] FsiItemType *itemType
);

Parameters

[in] fullPath

String that contains the fully qualified path of the directory or file to check.

[out] itemType

Indicates if the item is a file, a directory, or does not exist. For possible values, see the FsiItemType enumeration type.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code Description
E_POINTER
 Pointer is not valid.

Value: 0x80004003
IMAPI_E_INVALID_PARAM
 The value specified for parameter %1!ls! is not valid.

Value: 0xC0AAB101
IMAPI_E_INVALID_PATH
 The specified path is not fully qualified. The path must begin with '\\' or '/' to indicate the image root, or the images position within a directory structure.

Value: 0xC0AAB110
IMAPI_E_DIR_NOT_FOUND
 The directory '%1!s!' not found in FileSystemImage hierarchy.

Value: 0xC0AAB11A
E_NOINTERFACE
 The object doesn't support this interface.

Value: 0x80004002

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi2fs.h

See also

FsiItemType

IFileSystemImage