| 术语 | getntmsobjectattribute |
| 释义 | GetNtmsObjectAttribute 语法： C++ DWORD GetNtmsObjectAttribute( __in HANDLE hSession, __in LPNTMS_GUID lpObjectId, __in DWORD dwType, __in LPCTSTR lpAttributeName, __out LPVOID lpAttributeData, __inout LPDWORD lpAttributeSize ); GetNtmsObjectAttribute功能 [移动存储管理不再作为Windows 7和Windows服务器2008 R2提供。] 该GetNtmsObjectAttribute函数检索扩展属性(命名为从指定的罗申对象的私有数据)。 参数 hSession [in] 处理由OpenNtmsSession函数返回的会议。 lpObjectId [in] 唯一标识符的对象从中检索数据。 dwType [in] 丹参对象类型。 NtmsObjectsTypes对于对象类型的列表，请参阅。 lpAttributeName [in] 名称扩展属性，其数据要检索。 lpAttributeData [out] 指针的缓冲区，接收数据。 lpAttributeSize [ in , out ] 尺寸对输入数据缓冲区，以字节为单位。在输出的数据的实际大小，以字节。 返回值 这个函数返回下列值之一。 ValueMeaning ERROR_ACCESS_DENIEDNTMS_USE_ACCESS的对象或其容器被拒绝。其他安全错误也是可能的，但它们都将意味着安全子系统的错误。 Windows XP/2000操作系统：没有访问权限是必需的。 ERROR_DATABASE_FAILUREThe数据库查询或更新失败。 ERROR_INSUFFICIENT_BUFFERThe缓冲区的大小是不正确指定。正确的大小是在lpAttributeSize返回参数。 ERROR_INVALID_HANDLEThe价值hSession参数指定为NULL或无效。 ERROR_INVALID_PARAMETERThe指针为NULL或无效。 ERROR_NOT_CONNECTEDUnable连接到RSM服务。 ERROR_OBJECT_NOT_FOUNDThe指定的属性没有被发现。 ERROR_SUCCESSThe功能是成功的。 备注 该GetNtmsObjectAttribute函数必须执行丹参服务器上。由于缓冲区的字节之间的封送不同的架构系统，远程执行此功能可能会导致不可预知的结果。 以下是需要的对象的特殊访问权限的列表。 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_POOLRequires 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 namesGetNtmsObjectAttributeW(Unicode)和GetNtmsObjectAttributeA(ANSI)的 参见 对象管理职能 EnumerateNtmsObject SetNtmsObjectAttribute 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月30日 ＝＝英文原文＝＝GetNtmsObjectAttribute Function [ Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.] The GetNtmsObjectAttribute function retrieves the extended attribute (named private data) from the specified RSM object. Syntax C++ DWORD GetNtmsObjectAttribute( __in HANDLE hSession, __in LPNTMS_GUID lpObjectId, __in DWORD dwType, __in LPCTSTR lpAttributeName, __out LPVOID lpAttributeData, __inout LPDWORD lpAttributeSize ); Parameters hSession [in] Handle to the session returned by the OpenNtmsSession function. lpObjectId [in] Unique identifier of the object from which to retrieve the data. dwType [in] RSM object type. For a list of object types, see NtmsObjectsTypes . lpAttributeName [in] Name of the extended attribute whose data is to be retrieved. lpAttributeData [out] Pointer to the buffer that receives the data. lpAttributeSize [in, out] Size of the data buffer on input, in bytes. On output, the actual size of the data, in bytes. 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_DATABASE_FAILUREThe database query or update failed. ERROR_INSUFFICIENT_BUFFERThe buffer size is not correctly specified. The correct size is returned in the lpAttributeSize parameter. ERROR_INVALID_HANDLEThe value specified in the hSession parameter is NULL or is not valid. ERROR_INVALID_PARAMETERThe pointer is NULL or is not valid. ERROR_NOT_CONNECTEDUnable to connect to the RSM service. ERROR_OBJECT_NOT_FOUNDThe specified attribute was not found. ERROR_SUCCESSThe function was successful. Remarks The GetNtmsObjectAttribute function must be executed on the RSM server. Because the buffer of bytes is unmarshaled between systems of different architectures, remote execution of this function may result in unpredictable results. 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_POOLRequires NTMS_USE_ACCESS to the media pool. 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 namesGetNtmsObjectAttributeW (Unicode) and GetNtmsObjectAttributeA (ANSI) See Also Object Management Functions EnumerateNtmsObject SetNtmsObjectAttribute Send comments about this topic to Microsoft Build date: 7/30/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/bb525510(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。