deleteNtmsMedia 函数 (ntmsapi.h)
[从 Windows 7 和 Windows Server 2008 R2 起,可移动存储管理器 不再可用。]
DeleteNtmsMedia 函数通过从数据库中删除对指定媒体的所有引用,从 RSM 中删除脱机媒体的物理部分。
语法
DWORD DeleteNtmsMedia(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpMediaId
);
参数
[in] hSession
OpenNtmsSession 函数返回的会话的句柄。
[in] lpMediaId
一段物理介质的唯一标识符。
返回值
此函数返回以下值之一。
值 | 含义 |
---|---|
|
NTMS_MODIFY_ACCESS到计算机或媒体的媒体池被拒绝。 其他安全错误也可能存在,但它们表示存在安全子系统错误。
Windowsxp: 拒绝NTMS_MODIFY_ACCESS媒体的媒体池。 其他安全错误也可能存在,但它们表示存在安全子系统错误。 |
|
数据库不可访问或已损坏。 |
|
数据库已满。 |
|
会话句柄缺失或无效。 |
|
媒体标识符无效。 |
|
媒体的媒体池无效。 |
|
缺少媒体标识符。 |
|
媒体未脱机。 |
|
处理期间发生分配失败。 |
|
函数成功。 |
注解
DeleteNtmsMedia 函数指定的媒体必须位于脱机库中,并且没有处于“已分配”、“已完成”或“保留”状态的一侧。
可以使用 DeleteNtmsMedia 删除丢失或损坏的媒体。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | ntmsapi.h |
Library | Ntmsapi.lib |
DLL | Ntmsapi.dll |