Edit

IIsoImageManager::Validate method (imapi2fs.h)

  • Article

Determines if the provided .iso image is valid.

Syntax

HRESULT Validate();

Return value

This method can return one of these values.

Return code Description
IMAPI_E_IMAGEMANAGER_IMAGE_NOT_ALIGNED The image is not aligned on a 2kb sector boundary.
IMAPI_E_IMAGEMANAGER_NO_VALID_VD_FOUND The image does not contain a valid volume descriptor.
IMAPI_E_IMAGEMANAGER_NO_IMAGE The image has not been set using the SetPath or SetStream method prior to calling this method.
IMAPI_E_IMAGEMANAGER_IMAGE_TOO_BIG The provided image is too large to be validated as the size exceeds MAXLONG.

Remarks

For this method to succeed, the disc image, which may be a file or a stream, must meet the following criteria:

  • The disc image size must be a multiple of the sector user data size, 2048 bytes.
  • The disc image must contain user data only and no sector header or file header.
  • The disc image must contain a valid Volume Recognition Sequence with at least one Volume Descriptor such as described in ECMA 119, 167, 168 standards.

If the disc image does not fit these criteria, this method will return the relevant failure code. More importantly, a failure to validate will affect the probability of operation success when the image is mounted by Windows after recording.

This method is supported in Windows Server 2003 with Service Pack 1 (SP1), Windows XP with Service Pack 2 (SP2), and Windows Vista via the Windows Feature Pack for Storage. All features provided by this update package are supported natively in Windows 7 and Windows Server 2008 R2.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi2fs.h

See also