Partager via

IIsoImageManager ::Validate, méthode (imapi2fs.h)

  • Article

Détermine si l’image .iso fournie est valide.

Syntaxe

HRESULT Validate();

Valeur de retour

Cette méthode peut retourner l’une de ces valeurs.

Retourner le code Description
IMAPI_E_IMAGEMANAGER_IMAGE_NOT_ALIGNED L’image n’est pas alignée sur une limite de secteur de 2 Ko.
IMAPI_E_IMAGEMANAGER_NO_VALID_VD_FOUND L’image ne contient pas de descripteur de volume valide.
IMAPI_E_IMAGEMANAGER_NO_IMAGE L’image n’a pas été définie à l’aide du SetPath ou de la méthode SetStream avant d’appeler cette méthode.
IMAPI_E_IMAGEMANAGER_IMAGE_TOO_BIG L’image fournie est trop grande pour être validée, car la taille dépasse MAXLONG.

Remarques

Pour que cette méthode réussisse, l’image de disque, qui peut être un fichier ou un flux, doit répondre aux critères suivants :

  • La taille de l’image disque doit être un multiple de la taille des données utilisateur du secteur, 2048 octets.
  • L’image de disque doit contenir uniquement des données utilisateur et aucun en-tête de secteur ni en-tête de fichier.
  • L’image de disque doit contenir une séquence de reconnaissance de volume valide avec au moins un descripteur de volume tel que décrit dans ECMA 119, 167, 168 normes.

Si l’image de disque ne correspond pas à ces critères, cette méthode retourne le code d’échec approprié. Plus important encore, un échec de validation affecte la probabilité de réussite de l’opération lorsque l’image est montée par Windows après l’enregistrement.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête imapi2fs.h

Voir aussi