IPortableDeviceUnitsStream::SeekInUnits-Methode (portabledeviceapi.h)

Artikel
08/25/2023

Die SeekInUnits-Methode führt basierend auf alternativen Einheiten eine Suche für einen Stream aus.

Syntax

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

Parameter

[in] dlibMove

Die Verschiebung, die der durch den dwOrigin-Parameter angegebenen Position hinzugefügt werden soll. Die Einheiten für die Verschiebung werden durch Einheiten angegeben. Wenn dwOriginSTREAM_SEEK_SET ist, wird dies als nicht signierter Wert interpretiert.

[in] units

Die Einheiten der Parameter dlibMove und plibNewPosition . Weitere Informationen finden Sie unter WPD_STREAM_UNITS .

[in] dwOrigin

Der Ursprung für die in dlibMove angegebene Verschiebung. Der Ursprung kann der Anfang der Datei (STREAM_SEEK_SET), der aktuelle Suchzeiger (STREAM_SEEK_CUR) oder das Ende der Datei (STREAM_SEEK_END) sein. Weitere Informationen zu Werten finden Sie in der STREAM_SEEK-Enumeration .

[out, optional] plibNewPosition

Ein Zeiger auf die Position, an der diese Methode den Wert des neuen Suchzeigers vom Anfang des Datenstroms schreibt. Die Einheiten werden durch Einheiten angegeben. Sie können diesen Zeiger auf NULL festlegen. In diesem Fall stellt diese Methode den neuen Suchzeiger nicht bereit.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Der Suchzeiger wurde erfolgreich angepasst.
STG_E_INVALIDPOINTER	Gibt an, dass der [out]-Parameter plibNewPosition auf ungültigen Arbeitsspeicher verweist, da plibNewPosition nicht gelesen wird.
STG_E_INVALIDFUNCTION	Der dwUnits- oder dwOrigin-Parameter enthält einen ungültigen Wert, oder der dlibMove-Parameter enthält einen ungültigen Offsetwert. Das Ergebnis des Suchzeigers ist beispielsweise ein negativer Offsetwert.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h
Bibliothek	PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDeviceUnitsStream

WPD_STREAM_UNITS

Freigeben über