| 术语 | updatentmsomidinfo |
| 释义 | UpdateNtmsOmidInfo 语法： C++ DWORD UpdateNtmsOmidInfo( __in HANDLE hSession, __in LPNTMS_GUID lpMediaId, __in DWORD labelType, __in DWORD numberOfBytes, __in LPVOID lpBuffer ); UpdateNtmsOmidInfo功能 [移动存储管理不再作为Windows 7和Windows服务器2008 R2提供。] 该UpdateNtmsOmidInfo函数更新与RSM数据库标签信息后，立即以书面向新分配的媒介。 参数 hSession [in] 处理由OpenNtmsSession函数返回的会议。 lpMediaId [in] 唯一标识符的逻辑媒体上。 labelType [in] 标签类型。此参数可以是下列值之一。 ValueMeaning NTMS_OMID_TYPE_FILESYSTEM_INFOThe lpBuffer参数包含NTMS_FILESYSTEM_INFO结构。这个标志是用于媒体包含文件系统。 NTMS_OMID_TYPE_RAW_LABELThe lpBuffer参数包含应用标签的原始字节。这个标志是用于媒体的标签中包含的书面申请。 numberOfBytes [in] 在数lpBuffer参数发送的字节。 lpBuffer [in] 标签信息。该参数的格式取决于该labelType参数的值。 返回值 这个函数返回下列值之一。 ValueMeaning ERROR_ACCESS_DENIEDAccess到一个或多个罗申对象被拒绝。 ERROR_DATABASE_FAILUREThe数据库查询或更新失败。 ERROR_INVALID_HANDLEThe价值hSession参数中指定无效。 ERROR_INVALID_MEDIAUnable来检索数据库中定义的逻辑媒体。 ERROR_INVALID_PARTITIONUnable来检索数据库中方的定义。 ERROR_INVALID_PARAMETERThe lpMediaId参数是NULL。 ERROR_NOT_CONNECTEDUnable连接到RSM服务。 ERROR_SUCCESSThe功能是成功的。 备注 丹参中的应用与更新的UpdateNtmsOmidInfo功能和RSM验证数据库中的信息提供的资料。该标签的信息存储在与此相关的一方LMID RSM数据库。 该UpdateNtmsOmidInfo函数必须执行丹参服务器上。 Remote execution of this function results in an error. 对于磁带lpBuffer必须指向一个缓冲区保存在磁带上只写标签。在这个缓冲区中的数据直接传递到每个最低生活LevelClaimMediaLabel切入点。安装的MLLs人们必须认识到这种数据的有效标签。 For media with file systems, lpBuffer must be a pointer to a buffer that contains the following structure: typedef结构( 宽字符FileSystemType [64]; 宽字符卷名[256]; 双字节值周期介绍; )NTMS_FILESYSTEM_INFO; 罗申使用此作为奥米德文件系统信息。公用事业的格式(简称LDM，探险家，format.com等)有效地执行，因为这要求相同的功能。执行的应用程序与第三方文件系统类型自己的格式或格式应该只需要调用文件系统媒体UpdateNtmsOmidInfo。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 客户端 支持 Windows Vista 服务器 支持 Windows Server 2008 HeaderNtmsapi.h LibraryNtmsapi.lib DLLNtmsapi.dll 参见 On-Media-Identifier Management Functions 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月30日 ＝＝英文原文＝＝UpdateNtmsOmidInfo Function [ Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.] The UpdateNtmsOmidInfo function updates the RSM database with label information immediately after writing to the newly allocated medium. Syntax C++ DWORD UpdateNtmsOmidInfo( __in HANDLE hSession, __in LPNTMS_GUID lpMediaId, __in DWORD labelType, __in DWORD numberOfBytes, __in LPVOID lpBuffer ); Parameters hSession [in] Handle to the session returned by the OpenNtmsSession function. lpMediaId [in] Unique identifier of a piece of logical media. labelType [in] Label type. This parameter can be one of the following values. ValueMeaning NTMS_OMID_TYPE_FILESYSTEM_INFOThe lpBuffer parameter contains an NTMS_FILESYSTEM_INFO structure. This flag is used for media that contain file systems. NTMS_OMID_TYPE_RAW_LABELThe lpBuffer parameter contains the raw bytes of the application label. This flag is used for media that contain application written labels. numberOfBytes [in] Number of bytes sent in the lpBuffer parameter. lpBuffer [in] Label information. The format of this parameter depends on the value of the labelType parameter. Return Value This function returns one of the following values. ValueMeaning ERROR_ACCESS_DENIEDAccess to one or more RSM objects is denied. ERROR_DATABASE_FAILUREThe database query or update failed. ERROR_INVALID_HANDLEThe value specified in the hSession parameter is not valid. ERROR_INVALID_MEDIAUnable to retrieve the logical media definition from the database. ERROR_INVALID_PARTITIONUnable to retrieve the side definition from the database. ERROR_INVALID_PARAMETERThe lpMediaId parameter is NULL. ERROR_NOT_CONNECTEDUnable to connect to the RSM service. ERROR_SUCCESSThe function was successful. Remarks The application updates RSM with the information supplied by the UpdateNtmsOmidInfo function and RSM verifies the information in the database. The label information is stored in the RSM database with the side associated with this LMID. The UpdateNtmsOmidInfo function must be executed on the RSM server. Remote execution of this function results in an error. For tape media lpBuffer must point to a buffer that holds the label just written on the tape. The data in this buffer is passed directly to the ClaimMediaLabel entry point of each MLL. One of the installed MLLs must recognize a valid label in this data. For media with file systems, lpBuffer must be a pointer to a buffer that contains the following structure: typedef struct { WCHAR FileSystemType[64]; WCHAR VolumeName[256]; DWORD SerialNumber; } NTMS_FILESYSTEM_INFO; RSM uses this file system info as the OMID. The format utilities (LDM, explorer, format.com, etc.) effectively performs the same functionality as this call. An application that performs its own formatting or formats with a third-party file system type should only need to call UpdateNtmsOmidInfo for file system media. 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 On-Media-Identifier Management Functions Send comments about this topic to Microsoft Build date: 7/30/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/bb540750(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。