Método IIsoImageManager::Validate (imapi2fs.h)
Determina se a imagem de .iso fornecida é válida.
Sintaxe
HRESULT Validate();
Valor de retorno
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 do setor de 2kb. |
| 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. |
Observações
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 do 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 no ECMA 119, 167, 168 padrões.
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.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | imapi2fs.h |