网站首页  词典首页

请输入您要查询的函数:

 

术语 ejectntmsmedia
释义 EjectNtmsMedia
语法:
C++
DWORD EjectNtmsMedia(
__in HANDLE hSession,
__in LPNTMS_GUID lpMediaId,
__inout LPNTMS_GUID lpEjectOperation,
__in DWORD dwAction
);
EjectNtmsMedia功能
[移动存储管理不再作为Windows 7和Windows服务器2008 R2提供。]
弹出的EjectNtmsMedia函数从当前库中指定的端口。如果库繁忙,罗申队列EjectNtmsMedia和返回成功。
参数
hSession [in]
处理由OpenNtmsSession函数返回的会议。
lpMediaId [in]
唯一标识符的(关键词)物理媒体上。
lpEjectOperation [ in , out ]
弹出的GUID进程库的要求。如果dwAction是NTMS_EJECT_START,此参数接收的运作的GUID。如果dwAction是NTMS_EJECT_STOP,此参数必须设置为操作GUID来加以制止。此参数不使用NTMS_EJECT_QUEUE。
dwAction [in]
要执行的动作。此参数可以是下列值之一。
ValueMeaning
NTMS_EJECT_STARTStart与端口弹出操作。指定的媒介被弹出,直到超时事件发生时或函数的调用NTMS_EJECT_STOP了。超时值是在库指定对象,并应用到库的所有喷发。
NTMS_EJECT_STOPTerminate弹射过程中的失误进行了lpEjectOperation事件之前指定的时间。
NTMS_EJECT_QUEUEQueue弹出指定的媒体。用于将媒体多时隙NTMS_IEPORT对象。
返回值
这个函数返回下列值之一。
ValueMeaning
ERROR_ACCESS_DENIEDNTMS_CONTROL_ACCESS到库被拒绝。其他安全错误也是可能的,但它们都将意味着安全子系统的错误。
ERROR_BUSYMore媒体排队比插槽可用的NTMS_IEPORT对象。
ERROR_DATABASE_FAILUREThe数据库无法访问或已损坏。
ERROR_DATABASE_FULLThe数据库已满。
ERROR_DEVICE_NOT_AVAILABLEThe库被禁用。
ERROR_INVALID_HANDLEThe会话ID丢失或无效。
ERROR_INVALID_OPERATIONA站是行动上执行的ID是无效的。
ERROR_INVALID_PARAMETERA库ID或操作ID指针丢失。
ERROR_LIBRARY_OFFLINEThe库ID指的是一个脱机库,不能弹出媒体。
ERROR_MEDIA_NOT_AVAILABLEThe媒体被禁用。
ERROR_NOT_ENOUGH_MEMORYThere是在处理过程中分配失败。
ERROR_SUCCESSThe弹出排队。
备注
该EjectNtmsMedia函数返回到如弹出要求尽快申请排队。
媒体跳伞使用EjectNtmsMedia功能是移动到脱机库或从数据库中删除。清洁墨盒,import 的媒体,无法识别的媒体,和不兼容的媒体都将被删除时弹出。
该NTMS_EJECT_QUEUE标志用于捆绑或批量媒体弹射标志着成一个多槽库。您可以使用排队队列动作弹出应用程序时排队一切必要的媒体。该应用程序使用的启动命令,开始物理弹出操作。如果有更多的媒体比NTMS_IEPORT对象时段排队,EjectNtmsMedia返回ERROR_BUSY。要开始物理弹出操作,应用程序可以使用NTMS_EJECT_START与去年介质ID或NULL。
如果媒体是目前正在使用(安装或打开),此函数返回一个错误。
如果库没有一个端口,使用AccessNtmsLibraryDoor函数来插入和弹出媒体。
该EjectNtmsMedia功能不起作用的脱机库。
要求:
最低支持:client-Windows 2000专业版
最低支持server-Windows 2000服务器
客户端 支持 Windows Vista
服务器 支持 Windows Server 2008
HeaderNtmsapi.h
LibraryNtmsapi.lib
DLLNtmsapi.dll
参见
库控制功能
InjectNtmsMedia
如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com)
生成日期:2009年7月30日
==英文原文==EjectNtmsMedia Function
[ Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The EjectNtmsMedia function ejects the specified medium from the port of the current library. If the library is busy, RSM queues EjectNtmsMedia and returns success.
Syntax
C++
DWORD EjectNtmsMedia(
__in HANDLE hSession,
__in LPNTMS_GUID lpMediaId,
__inout LPNTMS_GUID lpEjectOperation,
__in DWORD dwAction
);
Parameters
hSession [in]
Handle to the session returned by the OpenNtmsSession function.
lpMediaId [in]
Unique identifier of a piece of physical media (PMID).
lpEjectOperation [in, out]
GUID of the eject process library request. If dwAction is NTMS_EJECT_START, this parameter receives the GUID for the operation. If dwAction is NTMS_EJECT_STOP, this parameter must be set to the GUID for the operation to be stopped. This parameter is not used with NTMS_EJECT_QUEUE.
dwAction [in]
Action to perform. This parameter can be one of the following values.
ValueMeaning
NTMS_EJECT_STARTStart the eject operation with a port. The specified medium is ejected until the time-out event occurs or the function is called again with NTMS_EJECT_STOP. The time-out value is specified in the library object and is applied to all ejections in the library.
NTMS_EJECT_STOPTerminate the ejection process specified by lpEjectOperation before the time-out event lapses.
NTMS_EJECT_QUEUEQueue the specified media for ejection. Used to group media for multi-slot NTMS_IEPORT objects.

Return Value
This function returns one of the following values.
ValueMeaning
ERROR_ACCESS_DENIEDNTMS_CONTROL_ACCESS to the library is denied. Other security errors are also possible, but they would indicate a security subsystem error.
ERROR_BUSYMore media was queued than slots available in the NTMS_IEPORT object.
ERROR_DATABASE_FAILUREThe database is inaccessible or damaged.
ERROR_DATABASE_FULLThe database is full.
ERROR_DEVICE_NOT_AVAILABLEThe library is disabled.
ERROR_INVALID_HANDLEThe session ID is missing or is not valid.
ERROR_INVALID_OPERATIONA stop was performed on an operation ID that was not valid.
ERROR_INVALID_PARAMETERA library ID or operation ID pointer is missing.
ERROR_LIBRARY_OFFLINEThe library ID refers to an offline library that cannot eject media.
ERROR_MEDIA_NOT_AVAILABLEThe media is disabled.
ERROR_NOT_ENOUGH_MEMORYThere was an allocation failure during processing.
ERROR_SUCCESSThe eject is queued.

Remarks
The EjectNtmsMedia function returns to the application as soon as the eject request is queued.
Media ejected using the EjectNtmsMedia function is moved to the offline library or deleted from the database. Cleaner cartridges, import media, unrecognized media, and incompatible media are deleted when ejected.
The NTMS_EJECT_QUEUE flag is used to bundle or batch media marked for ejection into a multi-slot library. You can queue media for ejection using the queue action when the application has queued all the necessary media. The application uses the start command to begin the physical eject operation. If more media is queued than slots in the NTMS_IEPORT object, EjectNtmsMedia returns ERROR_BUSY. To begin the physical eject operation, the application can use NTMS_EJECT_START with the last media ID or NULL.
If the media is currently in use (mounted or opened), this function returns an error.
If the library does not have a port, use the AccessNtmsLibraryDoor function to insert and eject media.
The EjectNtmsMedia function does not work with the offline library.
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
Library Control Functions
InjectNtmsMedia
Send comments about this topic to Microsoft
Build date: 7/30/2009
==原始网址==http://msdn.microsoft.com/en-us/library/bb525504(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 11:25:41