IFileSystemImage::CalculateDiscIdentifier-Methode (imapi2fs.h)

  • Artikel

Ruft eine Zeichenfolge ab, die einen Datenträger und die auf dem Datenträger aufgezeichneten Sitzungen identifiziert.

Syntax

HRESULT CalculateDiscIdentifier(
  [out] BSTR *discIdentifier
);

Parameter

[out] discIdentifier

Zeichenfolge, die eine Signatur enthält, die den Datenträger und die darauf enthaltenen Sitzungen identifiziert. Es ist nicht garantiert, dass diese Zeichenfolge zwischen Datenträgern eindeutig ist.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E_POINTER
 Der Zeiger ist ungültig.

Wert: 0x80004003
IMAPI_E_MULTISESSION_NOT_SET
 Die MultisessionInterfaces-Eigenschaft muss vor dem Aufrufen dieser Methode festgelegt werden.

Wert: 0xC0AAB15D

Hinweise

Beim Layering von Sitzungen auf einem Datenträger fungiert die Signatur als Schlüssel, mit dem der Client die Reihenfolge der Sitzung sicherstellen und Sitzungen auf dem Datenträger von Sitzungsbildern unterscheiden kann, die auf dem Datenträger abgelegt werden.

Sie müssen IFileSystemImage::p ut_MultisessionInterfaces aufrufen, bevor Sie CalculateDiscIdentifier aufrufen.

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

IFileSystemImage