System.Classes.TStreamAdapter.Seek

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Seek(dlibMove: Largeint; dwOrigin: DWORD; out libNewPosition: LargeUInt): HResult; virtual; stdcall;

C++

virtual HRESULT __stdcall Seek(__int64 dlibMove, unsigned dwOrigin, /* out */ unsigned __int64 &libNewPosition);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Classes.pas
System.Classes.hpp
System.Classes TStreamAdapter

Beschreibung

Implementiert die IStream-Methode Seek.

Seek verschiebt die aktuelle Position im Stream an die mit dlibMove und dwOrigin angegebene Position. Der Parameter dlibMove gibt die Anzahl Bytes und der Parameter dwOrigin den Ausgangspunkt der Operation an. Im Parameter libNewPosition wird die neue Position im Stream zurückgegeben.

Seek gibt S_OK zurück, wenn die Position im Stream erfolgreich geändert wurde. Der Rückgabewert lautet STG_E_INVALIDFUNCTION, wenn dlibMove den Wert STREAM_SEEK_SET oder STREAM_SEEK_END hat, da diese Suchoperationen von der Methode TStream.Seek nicht unterstützt werden. Schlägt die Suchoperation aus einem anderen Grund fehl, wird STG_E_INVALIDPOINTER zurückgegeben.

Siehe auch