IFileSystemImage::CreateDirectoryItem-Methode (imapi2fs.h)
Erstellen Sie ein Verzeichniselement mit dem angegebenen Namen.
Syntax
HRESULT CreateDirectoryItem(
[in] BSTR name,
[out] IFsiDirectoryItem **newItem
);
Parameter
[in] name
Zeichenfolge, die den Namen des zu erstellenden Verzeichniselements enthält.
[out] newItem
Eine IFsiDirectoryItem-Schnittstelle des neuen Verzeichniselements. Wenn Sie fertig sind, rufen Sie die IFsiDirectoryItem::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 für den Parameter %1!ls! angegebene Wert ist ungültig.
Wert: 0xC0AAB101 |
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
Hinweise
Nachdem Sie Eigenschaften für die IFsiDirectoryItem-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 |