IFileSystemImage::CalculateDiscIdentifier method (imapi2fs.h)

Retrieves a string that identifies a disc and the sessions recorded on the disc.

Syntax

HRESULT CalculateDiscIdentifier(
  [out] BSTR *discIdentifier
);

Parameters

[out] discIdentifier

String that contains a signature that identifies the disc and the sessions on it. This string is not guaranteed to be unique between discs.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code Description
E_POINTER
Pointer is not valid.

Value: 0x80004003

IMAPI_E_MULTISESSION_NOT_SET
MultisessionInterfaces property must be set prior calling this method.

Value: 0xC0AAB15D

Remarks

When layering sessions on a disc, the signature acts as a key that the client can use to ensure the session order, and to distinguish sessions on disc from session images that will be laid on the disc.

You must call IFileSystemImage::put_MultisessionInterfaces prior to calling CalculateDiscIdentifier.

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

IFileSystemImage