| 术语 | deallocatentmsmedia |
| 释义 | DeallocateNtmsMedia 语法： C++ DWORD DeallocateNtmsMedia( __in HANDLE hSession, __in LPNTMS_GUID lpMediaId, DWORD dwOptions ); DeallocateNtmsMedia功能 [移动存储管理不再作为Windows 7和Windows服务器2008 R2提供。] 该DeallocateNtmsMedia函数释放与指定的逻辑媒体相关的一面。 参数 hSession [in] 处理由OpenNtmsSession函数返回的会议。 lpMediaId [in] 唯一标识符(LMID)逻辑媒体。 dwOptions 版权所有;必须为零。 返回值 这个函数返回下列值之一。 ValueMeaning ERROR_ACCESS_DENIEDNTMS_CONTROL_ACCESS媒体的媒体池被拒绝。其他安全错误也是可能的，但它们都将意味着安全子系统的错误。 Windows XP/2000操作系统：媒体的媒体池NTMS_MODIFY_ACCESS被拒绝。其他安全错误也是可能的，但它们都将意味着安全子系统的错误。 ERROR_DATABASE_FAILUREThe数据库无法访问或已损坏。 ERROR_DATABASE_FULLThe数据库已满。 ERROR_INVALID_HANDLEThe会话句柄丢失或无效。 ERROR_INVALID_MEDIAThe LMID是无效的。 ERROR_INVALID_PARAMETERThe媒体或媒体池中ID丢失。 ERROR_INVALID_PARTITIONThe LMID一边是无效的。 ERROR_NOT_ENOUGH_MEMORYAn分配在处理过程中出现故障。 ERROR_SUCCESSThe功能是成功的。 备注 当一个合乎逻辑的媒介功能与DeallocateNtmsMedia释放，罗申提出，在可用的媒体或空置状态逻辑媒体相关的一面。逻辑媒体时删除逻辑媒体释放系统。 退役后，双方都释放，如果一方已分配在指定的媒体池最大次数。经过媒体，不能再次分配的空置状态。 Windows Server 2003的：如果媒体被返回到空闲池，NTMS_USE_ACCESS的空闲池和NTMS_CONTROL_ACCESS到源池是必需的。如果空闲池不是目的地媒体池，NTMS_CONTROL_ACCESS是在来源国和目的地池需要。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 客户端 支持 Windows Vista 服务器 支持 Windows Server 2008 HeaderNtmsapi.h LibraryNtmsapi.lib DLLNtmsapi.dll 参见 媒体服务函数 AllocateNtmsMedia 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月30日 ＝＝英文原文＝＝DeallocateNtmsMedia Function [ Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.] The DeallocateNtmsMedia function deallocates the side associated with the specified logical media. Syntax C++ DWORD DeallocateNtmsMedia( __in HANDLE hSession, __in LPNTMS_GUID lpMediaId, DWORD dwOptions ); Parameters hSession [in] Handle to the session returned by the OpenNtmsSession function. lpMediaId [in] Unique identifier of the logical media (LMID). dwOptions Reserved; must be zero. Return Value This function returns one of the following values. ValueMeaning ERROR_ACCESS_DENIEDNTMS_CONTROL_ACCESS to the media's media pool is denied. Other security errors are also possible, but they would indicate a security subsystem error. Windows XP/2000: NTMS_MODIFY_ACCESS to the media's media pool is denied. Other security errors are also possible, but they would indicate a security subsystem error. ERROR_DATABASE_FAILUREThe database is inaccessible or damaged. ERROR_DATABASE_FULLThe database is full. ERROR_INVALID_HANDLEThe session handle missing or is not valid. ERROR_INVALID_MEDIAThe LMID is not valid. ERROR_INVALID_PARAMETERThe media or media pool ID is missing. ERROR_INVALID_PARTITIONThe LMID side is not valid. ERROR_NOT_ENOUGH_MEMORYAn allocation failure occurred during processing. ERROR_SUCCESSThe function was successful. Remarks When a logical medium is deallocated with the DeallocateNtmsMedia function, RSM puts the side associated with the logical media in the Available or Decommissioned media state. The logical media is deleted from the system when the logical media is deallocated. Sides are decommissioned upon deallocation if the side has been allocated the maximum number of times specified in the media pool. After media is in the Decommissioned state, it cannot be allocated again. Windows Server 2003: If media is being returned to the free pool, NTMS_USE_ACCESS to the free pool and NTMS_CONTROL_ACCESS to the source pool is required. If the free pool is not the destination media pool, NTMS_CONTROL_ACCESS is required on both source and destination pools. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server End of client supportWindows Vista End of server supportWindows Server 2008 HeaderNtmsapi.h LibraryNtmsapi.lib DLLNtmsapi.dll See Also Media Services Functions AllocateNtmsMedia Send comments about this topic to Microsoft Build date: 7/30/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/bb525488(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。