Méthode SetAttributes de la classe MSFT_Partition

Définit différents attributs et propriétés de la partition.

Syntaxe

UInt32 SetAttributes(
  [in]  Boolean IsReadOnly,
  [in]  Boolean NoDefaultDriveLetter,
  [in]  Boolean IsActive,
  [in]  Boolean IsHidden,
  [out] String  ExtendedStatus
);

Paramètres

IsReadOnly [in]

Si la valeur est TRUE, la partition est en lecture seule. Si la valeur est FALSE, la partition est rendue accessible en écriture.

NoDefaultDriveLetter [in]

Si la valeur est TRUE, le système d’exploitation n’affecte pas de lettre de lecteur automatiquement lorsque la partition est découverte. Cette valeur est uniquement respectée pour les disques GPT et est supposée avoir la valeur FALSE pour les disques MBR. Cet attribut est utile dans les environnements SAN (Storage Area Network).

IsActive [in]

TRUE si la partition est une partition MBR active et peut être utilisée pour démarrer le système. Ce paramètre concerne uniquement les disques MBR.

IsHidden [in]

TRUE si la partition n’est pas détectée par le gestionnaire de montage. Par conséquent, la partition ne reçoit pas de lettre de lecteur, ne reçoit pas de chemin d’accès GUID de volume, n’héberge pas de points de montage de volume et n’est pas énumérée par les appels à FindFirstVolume et FindNextVolume. Cela garantit que les applications telles que le Défragmenteur de disque n'accèdent pas à la partition. Le service VSS (Volume Shadow Copy Service) utilise cet attribut sur ses clichés instantanés.

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)

En cours d’utilisation (6)

Accès refusé (40001)

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

Cache obsolète (40003)

Le disque n’a pas été initialisé. (41000)

Le disque est hors connexion. (41003)

Un paramètre n’est pas valide pour ce type de partition. (41006)

L’opération n’est pas autorisée sur un système ou une partition critique. (42010)

Configuration requise

Voir aussi

MSFT_Partition