IVdsVolumeMF::AddAccessPath-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.]

Fügt einen Zugriffspfad hinzu.

Syntax

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

Parameter

[in] pwszPath

Eine Zeichenfolge, die den Zugriffspfad angibt, bei dem es sich um einen Benutzermoduspfad handelt, der zum Öffnen des Volumes verwendet werden kann. Ein Zugriffspfad kann ein Laufwerkbuchstabe oder ein Pfad zu einem leeren Verzeichnis auf einem NTFS-Volume sein. Die Zugriffspfadzeichenfolge muss einen nachfolgenden umgekehrten Schrägstrich enthalten, z. B. "F:".

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
 Der Pfad wurde erfolgreich hinzugefügt.
S_FALSE
 Der Zugriffspfad wurde erfolgreich hinzugefügt, es ist jedoch ein Fehler aufgetreten. VDS konnte möglicherweise das GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER-Attribut einer Partition nicht aktualisieren oder beim Hinzufügen des Laufwerkbuchstabens eine Standardnetzwerkfreigabe (z. B. F$) hinzufügen. Weitere Informationen finden Sie unter PARTITION_INFORMATION_GPT.
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

VDS fügt den Zugriffspfad hinzu, indem ein eingebundener Ordner (auch als Volumeeinbindungspunkt bezeichnet) erstellt wird. Beachten Sie, dass bereitgestellte Ordner nur auf NTFS-Volumes unterstützt werden. Weitere Informationen finden Sie unter Eingebundene Ordner.

Diese Methode gibt ERROR_DIR_NOT_EMPTY zurück, wenn der pwszPath-Parameter einen Pfad zu einem bereitgestellten Ordner enthält, der bereits verwendet wird (auch wenn das Verzeichnis leer ist) oder wenn pwszPath einen Pfad zu einem nicht leeren Verzeichnis enthält.

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

SetVolumeMountPoint