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

Artikel
03/08/2023

[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

Freigeben über