Méthode IPortableDeviceUnitsStream::SeekInUnits (portabledeviceapi.h)

Article
08/25/2023

La méthode SeekInUnits effectue une recherche sur un flux, basée sur d’autres unités.

Syntaxe

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

Paramètres

[in] dlibMove

Déplacement à ajouter à l’emplacement indiqué par le paramètre dwOrigin . Les unités du déplacement sont spécifiées par unités. Si dwOrigin est STREAM_SEEK_SET, cela est interprété comme une valeur non signée plutôt qu’une valeur signée.

[in] units

Unités des paramètres dlibMove et plibNewPosition . Pour plus d’informations, consultez WPD_STREAM_UNITS .

[in] dwOrigin

Origine du déplacement spécifié dans dlibMove. L’origine peut être le début du fichier (STREAM_SEEK_SET), le pointeur de recherche actuel (STREAM_SEEK_CUR) ou la fin du fichier (STREAM_SEEK_END). Pour plus d’informations sur les valeurs, consultez l’énumération STREAM_SEEK .

[out, optional] plibNewPosition

Pointeur vers l’emplacement où cette méthode écrit la valeur du nouveau pointeur de recherche à partir du début du flux. Les unités sont données par unités. Vous pouvez définir ce pointeur sur NULL. Dans ce cas, cette méthode ne fournit pas le nouveau pointeur de recherche.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	Le pointeur de recherche a été ajusté avec succès.
STG_E_INVALIDPOINTER	Indique que le paramètre [out] plibNewPosition pointe vers la mémoire non valide, car plibNewPosition n’est pas lu.
STG_E_INVALIDFUNCTION	Le paramètre dwUnits ou dwOrigin contient une valeur non valide, ou le paramètre dlibMove contient une valeur de décalage incorrecte. Par exemple, le résultat du pointeur de recherche est une valeur de décalage négative.

Spécifications


Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	portabledeviceapi.h
Bibliothèque	PortableDeviceGUIDs.lib

Voir aussi

IPortableDeviceUnitsStream

WPD_STREAM_UNITS

Partager via