检索标识光盘和光盘上记录的会话的字符串。
语法
HRESULT CalculateDiscIdentifier(
[out] BSTR *discIdentifier
);
parameters
[out] discIdentifier
包含标识光盘及其上的会话的签名的字符串。 不保证此字符串在光盘之间是唯一的。
返回值
成功后返回S_OK,但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:
| 返回代码 | 说明 |
|---|---|
|
指针无效。
值:0x80004003 |
|
必须在调用此方法之前设置 MultisessionInterfaces 属性。
值:0xC0AAB15D |
注解
在光盘上分层会话时,签名充当密钥,客户端可以使用该密钥来确保会话顺序,并将光盘上的会话与放置在光盘上的会话映像区分开来。
在调用 CalculateDiscIdentifier 之前,必须调用 IFileSystemImage::p ut_MultisessionInterfaces。
要求
| 最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | imapi2fs.h |