IIsoImageManager::Validate-Methode (imapi2fs.h)
Bestimmt, ob das bereitgestellte ISO-Image gültig ist.
Syntax
HRESULT Validate();
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode | Beschreibung |
---|---|
IMAPI_E_IMAGEMANAGER_IMAGE_NOT_ALIGNED | Das Bild ist nicht an einer Sektorgrenze von 2 KB ausgerichtet. |
IMAPI_E_IMAGEMANAGER_NO_VALID_VD_FOUND | Das Bild enthält keinen gültigen Volumedeskriptor. |
IMAPI_E_IMAGEMANAGER_NO_IMAGE | Das Bild wurde vor dem Aufrufen dieser Methode nicht mithilfe der SetPath - oder SetStream-Methode festgelegt. |
IMAPI_E_IMAGEMANAGER_IMAGE_TOO_BIG | Das bereitgestellte Bild ist zu groß, um überprüft zu werden, da die Größe MAXLONG überschreitet. |
Hinweise
Damit diese Methode erfolgreich ist, muss das Datenträgerimage, bei dem es sich um eine Datei oder einen Stream handeln kann, die folgenden Kriterien erfüllen:
- Die Größe des Datenträgerimages muss ein Vielfaches der Sektorbenutzerdatengröße von 2048 Byte betragen.
- Das Datenträgerimage darf nur Benutzerdaten und keinen Sektorheader oder Dateiheader enthalten.
- Das Datenträgerbild muss eine gültige Volumeerkennungssequenz mit mindestens einem Volumedeskriptor enthalten, wie in ECMA 119, 167, 168 beschrieben.
Wenn das Datenträgerimage diese Kriterien nicht erfüllt, gibt diese Methode den relevanten Fehlercode zurück. Noch wichtiger ist, dass sich ein Fehler bei der Überprüfung auf die Wahrscheinlichkeit des erfolgreichen Vorgangs auswirkt, wenn das Image nach der Aufzeichnung von Windows bereitgestellt wird.
Diese Methode wird in Windows Server 2003 mit Service Pack 1 (SP1), Windows XP mit Service Pack 2 (SP2) und Windows Vista über das Windows Feature Pack for Storage unterstützt. Alle von diesem Updatepaket bereitgestellten Features werden in Windows 7 und Windows Server 2008 R2 nativ unterstützt.
Anforderungen
Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | imapi2fs.h |