Compartir a través de


Método IFileSystemImage::p ut_VolumeName (imapi2fs.h)

Establece el nombre del volumen de esta imagen del sistema de archivos.

Sintaxis

HRESULT put_VolumeName(
  [in] BSTR newVal
);

Parámetros

[in] newVal

Cadena que contiene el nombre del volumen de esta imagen del sistema de archivos.

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto Descripción
IMAPI_E_INVALID_VOLUME_NAME
El valor especificado para el parámetro %1!ls! no es válido.

Valor: 0xC0AAB101

Comentarios

La cadena está limitada a 15 caracteres. En el caso de los discos ISO 9660, el nombre del volumen puede usar los siguientes caracteres:

  • "A" a "Z"
  • "0" a "9"
  • "_" (subrayado)
En el caso de los discos UDFyn y, el nombre del volumen puede usar los siguientes caracteres:
  • "a" a "z"
  • "A" a "Z"
  • "0" a "9"
  • "." (período)
  • "_" (subrayado)
Si no especifica un nombre de volumen, se genera un nombre de volumen predeterminado mediante la fecha y hora del sistema cuando se crea el objeto de resultado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imapi2fs.h

Consulte también

IFileSystemImage

IFileSystemImage::get_ImportedVolumeName

IFileSystemImage::get_VolumeName