Compartilhar via

Método IIsoImageManager::Validate (imapi2fs.h)

  • Artigo

Determina se a imagem .iso fornecida é válida.

Sintaxe

HRESULT Validate();

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
IMAPI_E_IMAGEMANAGER_IMAGE_NOT_ALIGNED A imagem não está alinhada em um limite de setor de 2 kb.
IMAPI_E_IMAGEMANAGER_NO_VALID_VD_FOUND A imagem não contém um descritor de volume válido.
IMAPI_E_IMAGEMANAGER_NO_IMAGE A imagem não foi definida usando o método SetPath ou SetStream antes de chamar esse método.
IMAPI_E_IMAGEMANAGER_IMAGE_TOO_BIG A imagem fornecida é muito grande para ser validada, pois o tamanho excede MAXLONG.

Comentários

Para que esse método seja bem-sucedido, a imagem de disco, que pode ser um arquivo ou um fluxo, deve atender aos seguintes critérios:

  • O tamanho da imagem do disco deve ser um múltiplo do tamanho de dados do usuário do setor, 2048 bytes.
  • A imagem de disco deve conter apenas dados do usuário e nenhum cabeçalho de setor ou cabeçalho de arquivo.
  • A imagem de disco deve conter uma Sequência de Reconhecimento de Volume válida com pelo menos um Descritor de Volume, como descrito nos padrões ECMA 119, 167 e 168 .

Se a imagem de disco não se ajustar a esses critérios, esse método retornará o código de falha relevante. Mais importante, uma falha na validação afetará a probabilidade de sucesso da operação quando a imagem for montada pelo Windows após a gravação.

Esse método tem suporte no Windows Server 2003 com Service Pack 1 (SP1), Windows XP com Service Pack 2 (SP2) e Windows Vista por meio do Feature Pack do Windows para Armazenamento. Todos os recursos fornecidos por este pacote de atualização têm suporte nativo no Windows 7 e no Windows Server 2008 R2.

Requisitos

   
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