Partager via

IFileSystemImage ::p ut_VolumeName, méthode (imapi2fs.h)

  • Article

Définit le nom du volume pour cette image de système de fichiers.

Syntaxe

HRESULT put_VolumeName(
  [in] BSTR newVal
);

Paramètres

[in] newVal

Chaîne qui contient le nom du volume de cette image de système de fichiers.

Valeur retournée

S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour Description
IMAPI_E_INVALID_VOLUME_NAME
 La valeur spécifiée pour le paramètre %1 !ls ! n’est pas valide.

Valeur : 0xC0AAB101

Remarques

La chaîne est limitée à 15 caractères. Pour les disques ISO 9660, le nom du volume peut utiliser les caractères suivants :

  • « A » à « Z »
  • « 0 » à « 9 »
  • « _ » (trait de soulignement)
Pour les disques Joliet et UDF, le nom du volume peut utiliser les caractères suivants :
  • « a » à « z »
  • « A » à « Z »
  • « 0 » à « 9 »
  • "." (point)
  • « _ » (trait de soulignement)
Si vous ne spécifiez pas de nom de volume, un nom de volume par défaut est généré à l’aide de la date et de l’heure système de création de l’objet de résultat.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête imapi2fs.h

Voir aussi

IFileSystemImage

IFileSystemImage ::get_ImportedVolumeName

IFileSystemImage ::get_VolumeName