Metodo IFileSystemImage::p ut_VolumeName (imapi2fs.h)

  • Articolo

Imposta il nome del volume per l'immagine del file system.

Sintassi

HRESULT put_VolumeName(
  [in] BSTR newVal
);

Parametri

[in] newVal

Stringa contenente il nome del volume per l'immagine del file system.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito Descrizione
IMAPI_E_INVALID_VOLUME_NAME
 Il valore specificato per il parametro %1!ls! non è valido.

Valore: 0xC0AAB101

Commenti

La stringa è limitata a 15 caratteri. Per i dischi ISO 9660, il nome del volume può usare i caratteri seguenti:

  • "A" attraverso "Z"
  • "0" a "9"
  • "_" (sottolineatura)
Per i dischi Joliet e UDF, il nome del volume può usare i caratteri seguenti:
  • "a" attraverso "z"
  • "A" attraverso "Z"
  • "0" a "9"
  • "." (periodo)
  • "_" (sottolineatura)
Se non si specifica un nome di volume, viene generato un nome di volume predefinito usando la data e l'ora di sistema in cui viene creato l'oggetto risultato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione imapi2fs.h

Vedi anche

IFileSystemImage

IFileSystemImage::get_ImportedVolumeName

IFileSystemImage::get_VolumeName