Partager via


Méthode AddAccessPath de la classe MSFT_Partition

Ajoute une affectation de chemin de montage ou de lettre de lecteur à la partition.

Syntaxe

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

Paramètres

AccessPath [in]

Spécifie le chemin d’accès, qui est un chemin d’accès en mode utilisateur qui peut être utilisé pour ouvrir la partition. Un chemin d'accès peut être une lettre de lecteur (par exemple, « C: » ou « C:\ ») ou un chemin d'accès vers un répertoire vide sur un volume NTFS. La chaîne de chemin d'accès ne nécessite pas de barre oblique inverse de fin.

AssignDriveLetter [in]

Si la valeur est TRUE, la lettre de lecteur disponible suivante est affectée à la partition.

ExtendedStatus [out]

Chaîne qui contient un objet MSFT_StorageExtendedStatus incorporé.

Ce paramètre permet au fournisseur de stockage de retourner des informations d’erreur étendues (spécifiques à l’implémentation).

Valeur retournée

Réussite (0)

Non pris en charge (1)

Erreur non spécifiée (2)

Délai d’expiration (3)

Échec (4)

Paramètre non valide (5)

Accès refusé (40001)

Il n’y a pas suffisamment de ressources pour terminer l’opération. (40002)

Le chemin d’accès demandé est déjà utilisé. (42002)

Impossible d’attribuer des chemins d’accès aux partitions masquées. (42004)

Le chemin d’accès n’est pas valide. (42007)

Remarques

Cette méthode ajoute un chemin de montage ou une affectation de lettre de lecteur à la partition. Les paramètres AccessPath et AssignDriveLetter s’excluent mutuellement et entraînent une erreur paramètre non valide si les deux sont spécifiés à la fois. Cette méthode ajoute le chemin d’accès en créant un dossier monté (également appelé point de montage de volume). Notez que les dossiers montés sont pris en charge uniquement sur les partitions au format NTFS. Cette méthode retourne une erreur si le chemin spécifié dans AccessPath est un dossier déjà utilisé (même si le répertoire est vide) ou s’il contient un chemin d’accès à un répertoire non vide.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Espace de noms Root\Microsoft\Windows\Storage
En-tête Vds.h
MOF Storagewmi.mof

Voir aussi

MSFT_Partition