Share via

IIsoImageManager::Validate-Methode (imapi2fs.h)

  • Artikel

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

Weitere Informationen