IFileSystemImage::CreateFileItem-Methode (imapi2fs.h)
Erstellen Sie ein Dateielement mit dem angegebenen Namen.
Syntax
HRESULT CreateFileItem(
[in] BSTR name,
[out] IFsiFileItem **newItem
);
Parameter
[in] name
Zeichenfolge, die den Namen des zu erstellenden Dateielements enthält.
[out] newItem
Eine IFsiFileItem-Schnittstelle des neuen Dateielements. Wenn Sie fertig sind, rufen Sie die IFsiFileItem::Release-Methode auf, um die Schnittstelle freizugeben.
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 |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
|
Der angegebene Name ist ungültig.
Wert: 0xC0AAB101 |
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
Hinweise
Nachdem Sie Eigenschaften für die IFsiFileItem-Schnittstelle festgelegt haben, rufen Sie die IFsiDirectoryItem::Add-Methode für das übergeordnete Verzeichniselement auf, um sie dem Dateisystemimage hinzuzufügen.
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 |