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

dlibMoveplibNewPosition 参数的单位。 有关详细信息 ,请参阅WPD_STREAM_UNITS

[in] dwOrigin

dlibMove 中指定的位移的原点。 源可以是文件 (STREAM_SEEK_SET) 的开头、当前查找指针 (STREAM_SEEK_CUR) 或文件 (STREAM_SEEK_END) 的末尾。 有关值的详细信息,请参阅 STREAM_SEEK 枚举。

[out, optional] plibNewPosition

指向此方法从流开头写入新搜寻指针值的位置的指针的指针。 单位按单位提供。 可以将此指针设置为 NULL。 在这种情况下,此方法不提供新的搜寻指针。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
已成功调整搜寻指针。
STG_E_INVALIDPOINTER
指示 [out] 参数 plibNewPosition 指向无效内存,因为 plibNewPosition 未读取。
STG_E_INVALIDFUNCTION
dwUnitsdwOrigin 参数包含无效值,或者 dlibMove 参数包含错误的偏移值。 例如,查找指针的结果是负偏移量值。

要求

   
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 portabledeviceapi.h
Library PortableDeviceGUIDs.lib

请参阅

IPortableDeviceUnitsStream

WPD_STREAM_UNITS