网站首页  词典首页

请输入您要查询的函数:

 

术语 dismountntmsmedia
释义 DismountNtmsMedia
语法:
C++
DWORD DismountNtmsMedia(
__in HANDLE hSession,
__in LPNTMS_GUID lpMediaId,
__in DWORD dwCount,
__in DWORD dwOptions
);
DismountNtmsMedia功能
[移动存储管理不再作为Windows 7和Windows服务器2008 R2提供。]
DismountNtmsMedia函数的一个命令队列行进在指定的驱动器的存储媒体。这个函数应该搭配MountNtmsMedia功能。
参数
hSession [in]
处理由OpenNtmsSession函数返回的会议。
lpMediaId [in]
阵列至少有一个合乎逻辑的媒介或侧面。
dwCount [in]
媒体识别号码在lpMediaId参数。
dwOptions [in]
选项。此参数可以是以下值。
ValueMeaning
NTMS_DISMOUNT_DEFERREDMarks媒体的国家作为可拆卸,并保持在驱动器中的介质。随后安装的要求得到满足使用卸除或可拆卸的驱动器。默认是立即下马。
NTMS_DISMOUNT_IMMEDIATEDismount立即驱动器。
返回值
这个函数返回下列值之一。
ValueMeaning
ERROR_ACCESS_DENIEDNTMS_USE_ACCESS媒体池或库包含媒体被拒绝。其他安全错误也是可能的,但它们都将意味着安全子系统的错误。
ERROR_DATABASE_FAILUREThe数据库无法访问或已损坏。
ERROR_DATABASE_FULLThe数据库已满。
ERROR_DEVICE_NOT_AVAILABLEOne或要求执行卸载当前无法(可能禁用)更多的资源。
ERROR_INVALID_LIBRARYThe库包含媒体是无效的。
ERROR_INVALID_MEDIAAt至少指定的媒体之一,是无效的。
ERROR_INVALID_STATEAn意想不到的媒体或设备的状态发生在卸除。
ERROR_MEDIA_OFFLINEThe指定媒体处于脱机状态。
ERROR_MEDIA_NOT_AVAILABLEOne或多个媒体需要执行装入资源目前还没有(可能禁用)。
ERROR_NOT_ENOUGH_MEMORYA内存分配在处理过程中出现故障。
ERROR_SUCCESSThe媒体卸除已排队。
ERROR_TIMEOUTThe超时事件过期,而应用程序试图获得一个或更多的资源。
备注
应用程序必须使用DismountNtmsMedia函数来释放后,应用程序的驱动器资源利用指定的媒介。未发行的媒体无法使用其他丹参会议。
函数返回的DismountNtmsMedia尽快行动与丹参排队。应用程序可以等待端的状态,成为闲置。
要求:
最低支持:client-Windows 2000专业版
最低支持server-Windows 2000服务器
客户端 支持 Windows Vista
服务器 支持 Windows Server 2008
HeaderNtmsapi.h
LibraryNtmsapi.lib
DLLNtmsapi.dll
参见
媒体服务函数
MountNtmsMedia
如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com)
生成日期:2009年7月30日
==英文原文==DismountNtmsMedia Function
[ Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The DismountNtmsMedia function queues a command to move the specified media in a drive to its storage. This function should be paired with the MountNtmsMedia function.
Syntax
C++
DWORD DismountNtmsMedia(
__in HANDLE hSession,
__in LPNTMS_GUID lpMediaId,
__in DWORD dwCount,
__in DWORD dwOptions
);
Parameters
hSession [in]
Handle to the session returned by the OpenNtmsSession function.
lpMediaId [in]
Array of at least one logical medium or side.
dwCount [in]
Number of media identifiers in the lpMediaId parameter.
dwOptions [in]
Options. This parameter can be the following value.
ValueMeaning
NTMS_DISMOUNT_DEFERREDMarks media state as Dismountable, and keeps the medium in the drive. Subsequent mount requests are satisfied using dismounted or dismountable drives. The default is to dismount immediately.
NTMS_DISMOUNT_IMMEDIATEDismount the drive immediately.

Return Value
This function returns one of the following values.
ValueMeaning
ERROR_ACCESS_DENIEDNTMS_USE_ACCESS to the media pool or library that contains the media 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_DEVICE_NOT_AVAILABLEOne or more resources required to perform the dismount are not currently available (probably disabled).
ERROR_INVALID_LIBRARYThe library that contains the media is not valid.
ERROR_INVALID_MEDIAAt least one of the specified media is not valid.
ERROR_INVALID_STATEAn unexpected media or device state occurred during dismount.
ERROR_MEDIA_OFFLINEThe specified media is offline.
ERROR_MEDIA_NOT_AVAILABLEOne or more media resources required to perform the mount are not currently available (probably disabled).
ERROR_NOT_ENOUGH_MEMORYA memory allocation failure occurred during processing.
ERROR_SUCCESSThe media dismount has been queued.
ERROR_TIMEOUTThe time-out event expired while the application attempted to acquire one or more resources.

Remarks
An application must use the DismountNtmsMedia function to release the drive resource after the application has used the specified medium. Unreleased media cannot be used by other RSM sessions.
The DismountNtmsMedia function returns as soon as the operation is queued with RSM. The application can wait for the side state to become idle.
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
MountNtmsMedia
Send comments about this topic to Microsoft
Build date: 7/30/2009
==原始网址==http://msdn.microsoft.com/en-us/library/bb525500(VS.85).aspx\n
随便看

 

windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。

 

Copyright © 2004-2023 Winrtm.com All Rights Reserved
京ICP备2021023879号-40 更新时间:2024/10/6 13:24:37