Freigeben über

AddAccessPath-Methode der MSFT_Partition-Klasse

  • Artikel

Fügt der Partition einen Bereitstellungspfad oder eine Laufwerkbuchstabenzuweisung hinzu.

Syntax

UInt32 AddAccessPath(
  [in]  String  AccessPath,
  [in]  Boolean AssignDriveLetter,
  [out] String  ExtendedStatus
);

Parameter

AccessPath [in]

Gibt den Zugriffspfad an, bei dem es sich um einen Benutzermoduspfad handelt, der zum Öffnen der Partition verwendet werden kann. Ein Zugriffspfad kann entweder ein Laufwerksbuchstabe (Beispiel: „C:“ oder „C:\“) oder ein Pfad zu einem leeren Verzeichnis auf einem NTFS-Volume sein. Die Zeichenfolge für den Zugriffspfad benötigt keinen nachfolgenden umgekehrten Schrägstrich.

AssignDriveLetter [in]

Bei TRUE wird der nächste verfügbare Laufwerkbuchstabe der Partition zugewiesen.

ExtendedStatus [out]

Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.

Dieser Parameter ermöglicht es dem Speicheranbieter, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.

Rückgabewert

Erfolg (0)

Nicht unterstützt (1)

Nicht angegebener Fehler (2)

Timeout (3)

Fehler (4)

Ungültiger Parameter (5)

Zugriff verweigert (40001)

Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)

Der angeforderte Zugriffspfad wird bereits verwendet. (42002)

Zugriffspfade zu ausgeblendeten Partitionen können nicht zugewiesen werden. (42004)

Der Zugriffspfad ist ungültig. (42007)

Hinweise

Diese Methode fügt der Partition einen Bereitstellungspfad oder eine Laufwerkbuchstabenzuweisung hinzu. Die Parameter AccessPath und AssignDriveLetter schließen sich gegenseitig aus und führen zu einem Ungültigen Parameterfehler, wenn beide gleichzeitig angegeben werden. Diese Methode fügt den Zugriffspfad hinzu, indem ein eingebundener Ordner (auch als Volumeeinbindungspunkt bezeichnet) erstellt wird. Beachten Sie, dass eingebundene Ordner nur für NTFS-formatierte Partitionen unterstützt werden. Diese Methode gibt einen Fehler zurück, wenn der in AccessPath angegebene Pfad ein bereits verwendeter Ordner ist (auch wenn das Verzeichnis leer ist) oder wenn er einen Pfad zu einem nicht leeren Verzeichnis enthält.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Namespace Root\Microsoft\Windows\Storage
Header vds.h
MOF Storagewmi.mof

Weitere Informationen

MSFT_Partition