IVdsVolumeMF::D eleteAccessPath-Methode (vds.h)

  • Artikel

[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
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
VDS_E_OPERATION_DENIED
0x8004240AL
 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.
VDS_E_PATH_NOT_FOUND
0x80042416L
 Der angegebene Pfad wurde nicht gefunden.
VDS_E_DEVICE_IN_USE
0x80042413L
 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.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Fehler beim Volume.
VDS_E_PACK_OFFLINE
0x80042444L
 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

Weitere Informationen

IVdsVolumeMF

IVdsVolumeMF::AddAccessPath

IVdsVolumeMF::QueryAccessPaths