Compartilhar via

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

  • Artigo

Define o nome do volume para esta imagem do sistema de arquivos.

Sintaxe

HRESULT put_VolumeName(
  [in] BSTR newVal
);

Parâmetros

[in] newVal

Cadeia de caracteres que contém o nome do volume para essa imagem do sistema de arquivos.

Retornar valor

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
IMAPI_E_INVALID_VOLUME_NAME
 O valor especificado para o parâmetro %1!ls! não é válido.

Valor: 0xC0AAB101

Comentários

A cadeia de caracteres é limitada a 15 caracteres. Para discos ISO 9660, o nome do volume pode usar os seguintes caracteres:

  • "A" a "Z"
  • "0" a "9"
  • "_" (sublinhado)
Para discos Joliet e UDF, o nome do volume pode usar os seguintes caracteres:
  • "a" até "z"
  • "A" a "Z"
  • "0" a "9"
  • "." (ponto final)
  • "_" (sublinhado)
Se você não especificar um nome de volume, um nome de volume padrão será gerado usando a data e a hora do sistema em que o objeto de resultado é criado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imapi2fs.h

Confira também

IFileSystemImage

IFileSystemImage::get_ImportedVolumeName

IFileSystemImage::get_VolumeName