IVdsVolumeMF::AddAccessPath-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.]
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 |
|---|---|
|
Der Pfad wurde erfolgreich hinzugefügt. |
|
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. |
|
Fehler beim Volume. |
|
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 |