IPortableDeviceUnitsStream::SeekInUnits 方法 (portabledeviceapi.h)
SeekInUnits 方法基于备用单位对流执行查找。
语法
HRESULT SeekInUnits(
[in] LARGE_INTEGER dlibMove,
[in] WPD_STREAM_UNITS units,
[in] DWORD dwOrigin,
[out, optional] ULARGE_INTEGER *plibNewPosition
);
parameters
[in] dlibMove
要添加到 dwOrigin 参数指示的位置的位移。 位移的单位由 单位指定。 如果 dwOrigin是STREAM_SEEK_SET,则会将其解释为无符号值,而不是有符号值。
[in] units
dlibMove 和 plibNewPosition 参数的单位。 有关详细信息 ,请参阅WPD_STREAM_UNITS 。
[in] dwOrigin
dlibMove 中指定的位移的原点。 源可以是文件 (STREAM_SEEK_SET) 的开头、当前查找指针 (STREAM_SEEK_CUR) 或文件 (STREAM_SEEK_END) 的末尾。 有关值的详细信息,请参阅 STREAM_SEEK 枚举。
[out, optional] plibNewPosition
指向此方法从流开头写入新搜寻指针值的位置的指针的指针。 单位按单位提供。 可以将此指针设置为 NULL。 在这种情况下,此方法不提供新的搜寻指针。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
已成功调整搜寻指针。 |
|
指示 [out] 参数 plibNewPosition 指向无效内存,因为 plibNewPosition 未读取。 |
|
dwUnits 或 dwOrigin 参数包含无效值,或者 dlibMove 参数包含错误的偏移值。 例如,查找指针的结果是负偏移量值。 |
要求
最低受支持的客户端 | Windows 8 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |