网站首页  词典首页

请输入您要查询的函数:

 

术语 getntmsobjectinformation
释义 GetNtmsObjectInformation
语法:
C++
DWORD GetNtmsObjectInformation(
__in HANDLE hSession,
__in LPNTMS_GUID lpObjectId,
__out LPNTMS_OBJECTINFORMATION lpInfo
);
GetNtmsObjectInformation功能
[移动存储管理不再作为Windows 7和Windows服务器2008 R2提供。]
该GetNtmsObjectInformation函数返回一个对象的指定对象的信息结构。
参数
hSession [in]
处理由OpenNtmsSession函数返回的会议。
lpObjectId [in]
唯一标识符丹参对象。
lpInfo [out]
指针的NTMS_OBJECTINFORMATION结构,接收对象的信息。
返回值
这个函数返回下列值之一。
ValueMeaning
ERROR_ACCESS_DENIEDNTMS_USE_ACCESS的对象或其容器被拒绝。其他安全错误也是可能的,但它们都将意味着安全子系统的错误。
Windows XP/2000操作系统:没有访问权限是必需的。
ERROR_INVALID_HANDLEThe会话句柄丢失或无效。
ERROR_INVALID_PARAMETERThe对象ID或信息结构丢失,或对象的信息或对象类型的大小是无效的。
ERROR_NOT_ENOUGH_MEMORYAn分配在处理过程中出现故障。
ERROR_OBJECT_NOT_FOUNDThe对象ID是无效的。
ERROR_SUCCESSThe功能是成功的。
备注
这些信息的规模和结构类型的信息必须设置在lpInfo参数正确,然后才使用GetNtmsObjectInformation功能。
为了避免不可预知的结果,应用程序必须调用之前调用SetNtmsObjectInformation函数GetNtmsObjectInformation功能。该SetNtmsObjectInformation函数更新的NTMS_OBJECTINFORMATION结构的所有可写的成员,因此,应用程序负责提供所有可写成员的价值。
以下是需要的对象的特殊访问权限的列表。
ObjectAccess
NTMS_CHANGERRequires NTMS_USE_ACCESS库。
NTMS_CHANGER_TYPERequires NTMS_USE_ACCESS到计算机。
NTMS_COMPUTERRequires NTMS_USE_ACCESS到计算机。
NTMS_DRIVERequires NTMS_USE_ACCESS库。
NTMS_DRIVE_TYPERequires NTMS_USE_ACCESS到计算机。
NTMS_IEDOORRequires NTMS_USE_ACCESS库。
NTMS_IEPORTRequires NTMS_USE_ACCESS库。
NTMS_LIBRARYRequires NTMS_USE_ACCESS库。
NTMS_LIBREQUESTRequires NTMS_USE_ACCESS库。
NTMS_LOGICAL_MEDIARequires NTMS_USE_ACCESS的逻辑媒体的媒体池。
NTMS_MEDIA_TYPERequires NTMS_USE_ACCESS到计算机。
NTMS_OPREQUESTRequires NTMS_USE_ACCESS到计算机。
NTMS_PARTITIONRequires NTMS_USE_ACCESS向一侧媒体池。
NTMS_PHYSICAL_MEDIARequires NTMS_USE_ACCESS媒体池。
NTMS_STORAGESLOTRequires NTMS_USE_ACCESS库。
要求:
最低支持:client-Windows 2000专业版
最低支持server-Windows 2000服务器
客户端 支持 Windows Vista
服务器 支持 Windows Server 2008
HeaderNtmsapi.h
LibraryNtmsapi.lib
DLLNtmsapi.dll
Unicode和ANSI namesGetNtmsObjectInformationW(Unicode)和GetNtmsObjectInformationA(ANSI)的
参见
对象管理职能
GetNtmsObjectSecurity
NTMS_OBJECTINFORMATION
SetNtmsObjectInformation
如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com)
生成日期:2009年7月30日
==英文原文==GetNtmsObjectInformation Function
[ Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The GetNtmsObjectInformation function returns an object's information structure for the specified object.
Syntax
C++
DWORD GetNtmsObjectInformation(
__in HANDLE hSession,
__in LPNTMS_GUID lpObjectId,
__out LPNTMS_OBJECTINFORMATION lpInfo
);
Parameters
hSession [in]
Handle to the session returned by the OpenNtmsSession function.
lpObjectId [in]
Unique identifier of the RSM object.
lpInfo [out]
Pointer to an NTMS_OBJECTINFORMATION structure that receives the object information.
Return Value
This function returns one of the following values.
ValueMeaning
ERROR_ACCESS_DENIEDNTMS_USE_ACCESS to the object or its container is denied. Other security errors are also possible, but they would indicate a security subsystem error.
Windows XP/2000: No access rights are required.
ERROR_INVALID_HANDLEThe session handle is missing or is not valid.
ERROR_INVALID_PARAMETERThe object ID or information structure is missing, or the object information size or object type is not valid.
ERROR_NOT_ENOUGH_MEMORYAn allocation failure occurred during processing.
ERROR_OBJECT_NOT_FOUNDThe object ID is not valid.
ERROR_SUCCESSThe function was successful.

Remarks
The information size and type of the information structure must be set correctly in the lpInfo parameter before you use the GetNtmsObjectInformation function.
To avoid unpredictable results, applications must call the GetNtmsObjectInformation function before calling the SetNtmsObjectInformation function. The SetNtmsObjectInformation function updates all writable members of the NTMS_OBJECTINFORMATION structure, therefore the application is responsible for providing a value for all writable members.
The following is the list of objects that require special access rights.
ObjectAccess
NTMS_CHANGERRequires NTMS_USE_ACCESS to the library.
NTMS_CHANGER_TYPERequires NTMS_USE_ACCESS to the computer.
NTMS_COMPUTERRequires NTMS_USE_ACCESS to the computer.
NTMS_DRIVERequires NTMS_USE_ACCESS to the library.
NTMS_DRIVE_TYPERequires NTMS_USE_ACCESS to the computer.
NTMS_IEDOORRequires NTMS_USE_ACCESS to the library.
NTMS_IEPORTRequires NTMS_USE_ACCESS to the library.
NTMS_LIBRARYRequires NTMS_USE_ACCESS to the library.
NTMS_LIBREQUESTRequires NTMS_USE_ACCESS to the library.
NTMS_LOGICAL_MEDIARequires NTMS_USE_ACCESS to the media pool of the logical media.
NTMS_MEDIA_TYPERequires NTMS_USE_ACCESS to the computer.
NTMS_OPREQUESTRequires NTMS_USE_ACCESS to the computer.
NTMS_PARTITIONRequires NTMS_USE_ACCESS to the media pool of the side.
NTMS_PHYSICAL_MEDIARequires NTMS_USE_ACCESS to the media pool.
NTMS_STORAGESLOTRequires NTMS_USE_ACCESS to the 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
Unicode and ANSI namesGetNtmsObjectInformationW (Unicode) and GetNtmsObjectInformationA (ANSI)
See Also
Object Management Functions
GetNtmsObjectSecurity
NTMS_OBJECTINFORMATION
SetNtmsObjectInformation
Send comments about this topic to Microsoft
Build date: 7/30/2009
==原始网址==http://msdn.microsoft.com/en-us/library/bb525511(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:30:33