IIsoImageManager::Validate-Methode (imapi2fs.h)

  • Artikel

Bestimmt, ob das bereitgestellte .iso Bild 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 wird 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.

Bemerkungen

Damit diese Methode erfolgreich ausgeführt werden kann, muss das Datenträgerimage, das eine Datei oder ein Datenstrom sein kann, die folgenden Kriterien erfüllen:

  • Die Datenträgerbildgröße muss ein Vielfaches der Datengröße des Sektorbenutzers sein, 2048 Byte.
  • 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, z. B. in ECMA 119, 167, 168 Standards beschrieben.

Wenn das Datenträgerimage diese Kriterien nicht erfüllt, gibt diese Methode den relevanten Fehlercode zurück. Wichtiger ist, dass ein Fehler bei der Überprüfung die Wahrscheinlichkeit des Vorgangserfolgs beeinflusst, wenn das Image nach der Aufzeichnung von Windows bereitgestellt wird.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- imapi2fs.h

Siehe auch