Metode IPortableDeviceUnitsStream::SeekInUnits (portabledeviceapi.h)

Artikel
03/15/2023

Metode SeekInUnits melakukan pencarian pada aliran, berdasarkan unit alternatif.

Sintaks

HRESULT SeekInUnits(
  [in]            LARGE_INTEGER    dlibMove,
  [in]            WPD_STREAM_UNITS units,
  [in]            DWORD            dwOrigin,
  [out, optional] ULARGE_INTEGER   *plibNewPosition
);

Parameter

[in] dlibMove

Perpindahan untuk ditambahkan ke lokasi yang ditunjukkan oleh parameter dwOrigin . Unit untuk perpindahan ditentukan oleh unit. Jika dwOriginSTREAM_SEEK_SET, ini ditafsirkan sebagai nilai yang tidak ditandatangani daripada nilai yang ditandatangani.

[in] units

Unit parameter dlibMove dan plibNewPosition . Lihat WPD_STREAM_UNITS untuk detail selengkapnya.

[in] dwOrigin

Asal untuk perpindahan yang ditentukan dalam dlibMove. Asalnya dapat menjadi awal file (STREAM_SEEK_SET), penunjuk pencarian saat ini (STREAM_SEEK_CUR), atau akhir file (STREAM_SEEK_END). Untuk informasi selengkapnya tentang nilai, lihat enumerasi STREAM_SEEK .

[out, optional] plibNewPosition

Penunjuk ke lokasi tempat metode ini menulis nilai penunjuk pencarian baru dari awal aliran. Unit diberikan oleh unit. Anda dapat mengatur penunjuk ini ke NULL. Dalam hal ini, metode ini tidak menyediakan penunjuk pencarian baru.

Menampilkan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Penunjuk pencarian berhasil disesuaikan.
STG_E_INVALIDPOINTER	Menunjukkan bahwa parameter [out] plibNewPosition menunjuk ke memori yang tidak valid, karena plibNewPosition tidak dibaca.
STG_E_INVALIDFUNCTION	Parameter dwUnits atau dwOrigin berisi nilai yang tidak valid, atau parameter dlibMove berisi nilai offset yang buruk. Misalnya, hasil penunjuk pencarian adalah nilai offset negatif.

Persyaratan


Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	portabledeviceapi.h
Pustaka	PortableDeviceGUIDs.lib

Lihat juga

IPortableDeviceUnitsStream

WPD_STREAM_UNITS

Bagikan melalui