IVdsVolumeMF::D eleteAccessPath-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]
Entfernt den Zugriffspfad vom aktuellen Volume.
Syntax
HRESULT DeleteAccessPath(
[in] LPWSTR pwszPath,
[in] BOOL bForce
);
Parameter
[in] pwszPath
Eine Zeichenfolge, die den zu entfernenden Zugriffspfad enthält. Ein Zugriffspfad kann ein Laufwerkbuchstabe oder ein Pfad zu einem leeren Verzeichnis auf einem NTFS-Volume sein. Wenn es sich um einen Laufwerkbuchstaben handelt, müssen Sie einen nachgestellten umgekehrten Schrägstrich einfügen, z. B. "F:". Wenn es sich um einen Pfad zu einem Verzeichnis handelt, ist der nachfolgende umgekehrte Schrägstrich nicht erforderlich, z. B. "C:\MyFolder\MyDocuments".
[in] bForce
Wenn TRUE, wird der Zugriffspfad bedingungslos gelöscht, auch wenn das Volume verwendet wird. Dieser Parameter ist nur dann sinnvoll, wenn der Zugriffspfad ein Laufwerkbuchstabe ist.
Rückgabewert
Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des makros HRESULT_FROM_WIN32 zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der Pfad führt zum Systemvolume, zum Startvolume, zum Crashdump-Volume, zum Ruhezustandsvolume oder zum Pagefile-Volume. Sie können den Laufwerkbuchstaben nicht von diesen Volumes entfernen. |
|
Der angegebene Pfad wurde nicht gefunden. |
|
Der Zugriffspfad wurde erfolgreich gelöscht, es ist jedoch ein Fehler aufgetreten. VDS konnte möglicherweise das GPT-Attribut (GUID Partition Table) einer Partition aktualisieren oder eine Standardnetzwerkfreigabe (z. B. F$) beim Löschen des Laufwerkbuchstabens löschen. |
|
Fehler beim Volume. |
|
Auf das Paket, das das Volume enthält, kann nicht zugegriffen werden. |
Hinweise
Wenn auf dem Volume keine geöffneten Handles vorhanden sind, wird der Laufwerkbuchstabe sofort entfernt. Wenn jedoch auf dem Volume geöffnete Handles vorhanden sind, kann das Volume nicht gesperrt werden, und der Laufwerkbuchstabe wird entfernt, wenn der Computer neu gestartet wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vds.h |
| Bibliothek | Uuid.lib |