| 术语 | backupseek |
| 释义 | BackupSeek 语法： C++ BOOL BackupSeek( __in HANDLE hFile, __in DWORD dwLowBytesToSeek, __in DWORD dwHighBytesToSeek, __out LPDWORD lpdwLowByteSeeked, __out LPDWORD lpdwHighByteSeeked, __in LPVOID *lpContext ); BackupSeek功能 该BackupSeek功能要求，在最初提出使用BackupRead或BackupWrite函数访问数据流。 参数 hFile [in] 处理的文件或目录。这种处理是通过使用CreateFile函数创建。 句柄必须同步(同步方式)。这意味着FILE_FLAG_OVERLAPPED标志不得时设置CreateFile调用。此函数不验证它接收的处理是同步的，因此它不返回错误代码的同步处理，而是一个异步调用(重叠它)处理可以细微的错误结果，是很难调试。 dwLowBytesToSeek [in] 低位的字节数时设法。 dwHighBytesToSeek [in] 高阶的字节数时设法。 lpdwLowByteSeeked [out] 指针变量，它接收低的字节数函数的序位，其实便是。 lpdwHighByteSeeked [out] 指针变量，它接收高字节数函数的序位，其实便是。 lpContext [in] 指针的内部数据结构的函数使用。这个结构必须是相同的结构是由BackupRead函数中初始化。应用程序必须不涉及此结构的内容。 返回值 如果该函数可以要求所要求的数额，该函数返回一个非零值。 如果该函数不能寻求要求的数额，该函数返回零。为了获得更多错误信息，调用GetLastError。 备注 应用程序使用BackupSeek功能跳过数据流的某些部分，导致错误。此函数不寻求在流头。例如，此功能不能用于跳过流名称。如果一个应用程序试图寻找过去的子流结束时，函数失败，lpdwLowByteSeeked和lpdwHighByteSeeked参数显示的字节的功能要求的实际人数，以及文件中的位置是在开始下一个流头放置。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderWinbase.h(头文件：winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 BackupRead BackupWrite CreateFile 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月30日 ＝＝英文原文＝＝BackupSeek Function The BackupSeek function seeks forward in a data stream initially accessed by using the BackupRead or BackupWrite function. Syntax C++ BOOL BackupSeek( __in HANDLE hFile, __in DWORD dwLowBytesToSeek, __in DWORD dwHighBytesToSeek, __out LPDWORD lpdwLowByteSeeked, __out LPDWORD lpdwHighByteSeeked, __in LPVOID *lpContext ); Parameters hFile [in] Handle to the file or directory. This handle is created by using the CreateFile function. The handle must be synchronous (nonoverlapped). This means that the FILE_FLAG_OVERLAPPED flag must not be set when CreateFile is called. This function does not validate that the handle it receives is synchronous, so it does not return an error code for a synchronous handle, but calling it with an asynchronous (overlapped) handle can result in subtle errors that are very difficult to debug. dwLowBytesToSeek [in] Low-order part of the number of bytes to seek. dwHighBytesToSeek [in] High-order part of the number of bytes to seek. lpdwLowByteSeeked [out] Pointer to a variable that receives the low-order bits of the number of bytes the function actually seeks. lpdwHighByteSeeked [out] Pointer to a variable that receives the high-order bits of the number of bytes the function actually seeks. lpContext [in] Pointer to an internal data structure used by the function. This structure must be the same structure that was initialized by the BackupRead function. An application must not touch the contents of this structure. Return Value If the function could seek the requested amount, the function returns a nonzero value. If the function could not seek the requested amount, the function returns zero. To get extended error information, call GetLastError . Remarks Applications use the BackupSeek function to skip portions of a data stream that cause errors. This function does not seek across stream headers. For example, this function cannot be used to skip the stream name. If an application attempts to seek past the end of a substream, the function fails, the lpdwLowByteSeeked and lpdwHighByteSeeked parameters indicate the actual number of bytes the function seeks, and the file position is placed at the start of the next stream header. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also BackupRead BackupWrite CreateFile Send comments about this topic to Microsoft Build date: 7/30/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/aa362510(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。