Metodo IPortableDeviceUnitsStream::SeekInUnits (portabledeviceapi.h)

Articolo
08/25/2023

Il metodo SeekInUnits esegue una ricerca su un flusso, in base alle unità alternative.

Sintassi

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

Parametri

[in] dlibMove

Spostamento da aggiungere alla posizione indicata dal parametro dwOrigin . Le unità per lo spostamento vengono specificate dalle unità. Se dwOrigin è STREAM_SEEK_SET, viene interpretato come un valore senza segno anziché un valore con segno.

[in] units

Unità dei parametri dlibMove e plibNewPosition . Per altri dettagli, vedere WPD_STREAM_UNITS .

[in] dwOrigin

Origine dello spostamento specificato in dlibMove. L'origine può essere l'inizio del file (STREAM_SEEK_SET), il puntatore di ricerca corrente (STREAM_SEEK_CUR) o la fine del file (STREAM_SEEK_END). Per altre informazioni sui valori, vedere l'enumerazione STREAM_SEEK .

[out, optional] plibNewPosition

Puntatore alla posizione in cui questo metodo scrive il valore del nuovo puntatore seek dall'inizio del flusso. Le unità vengono fornite dalle unità. È possibile impostare questo puntatore su NULL. In questo caso, questo metodo non fornisce il nuovo puntatore seek.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il puntatore di ricerca è stato modificato correttamente.
STG_E_INVALIDPOINTER	Indica che il parametro [out] plibNewPosition punta a memoria non valida, perché plibNewPosition non è letto.
STG_E_INVALIDFUNCTION	Il parametro dwUnits o dwOrigin contiene un valore non valido oppure il parametro dlibMove contiene un valore di offset non valido. Ad esempio, il risultato del puntatore di ricerca è un valore di offset negativo.

Requisiti


Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

IPortableDeviceUnitsStream

WPD_STREAM_UNITS

Condividi tramite