IFileSystemImage::Exists-Methode (imapi2fs.h)

  • Artikel

Überprüft, ob eine bestimmte Datei oder ein bestimmtes Verzeichnis vorhanden ist.

Syntax

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

Parameter

[in] fullPath

Zeichenfolge, die den vollqualifizierten Pfad des zu überprüfenden Verzeichnisses oder der zu überprüfenden Datei enthält.

[out] itemType

Gibt an, ob das Element eine Datei, ein Verzeichnis ist oder nicht vorhanden ist. Mögliche Werte finden Sie unter dem FsiItemType-Enumerationstyp .

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E_POINTER
 Der Zeiger ist ungültig.

Wert: 0x80004003
IMAPI_E_INVALID_PARAM
 Der für den Parameter %1!ls! angegebene Wert ist ungültig.

Wert: 0xC0AAB101
IMAPI_E_INVALID_PATH
 Der angegebene Pfad ist nicht voll qualifiziert. Der Pfad muss mit "\\" oder "/" beginnen, um den Imagestamm oder die Bildposition innerhalb einer Verzeichnisstruktur anzugeben.

Wert: 0xC0AAB110
IMAPI_E_DIR_NOT_FOUND
 Das Verzeichnis '%1!s!' in der FileSystemImage-Hierarchie nicht gefunden.

Wert: 0xC0AAB11A
E_NOINTERFACE
 Das -Objekt unterstützt diese Schnittstelle nicht.

Wert: 0x80004002

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile imapi2fs.h

Weitere Informationen

FsiItemType

IFileSystemImage