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

El método SeekInUnits realiza una búsqueda en una secuencia, basada en unidades alternativas.

Sintaxis

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

Parámetros

[in] dlibMove

Desplazamiento que se va a agregar a la ubicación indicada por el parámetro dwOrigin . Las unidades para el desplazamiento se especifican mediante unidades. Si dwOrigin es STREAM_SEEK_SET, se interpreta como un valor sin signo en lugar de un valor con signo.

[in] units

Unidades de los parámetros dlibMove y plibNewPosition . Consulte WPD_STREAM_UNITS para obtener más detalles.

[in] dwOrigin

Origen del desplazamiento especificado en dlibMove. El origen puede ser el principio del archivo (STREAM_SEEK_SET), el puntero de búsqueda actual (STREAM_SEEK_CUR) o el final del archivo (STREAM_SEEK_END). Para obtener más información sobre los valores, vea la enumeración STREAM_SEEK .

[out, optional] plibNewPosition

Puntero a la ubicación donde este método escribe el valor del nuevo puntero de búsqueda desde el principio de la secuencia. Las unidades se proporcionan por unidades. Puede establecer este puntero en NULL. En este caso, este método no proporciona el nuevo puntero de búsqueda.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El puntero de búsqueda se ha ajustado correctamente.
STG_E_INVALIDPOINTER	Indica que el parámetro [out] plibNewPosition apunta a memoria no válida, porque plibNewPosition no se lee.
STG_E_INVALIDFUNCTION	El parámetro dwUnits o dwOrigin contiene un valor no válido o el parámetro dlibMove contiene un valor de desplazamiento incorrecto. Por ejemplo, el resultado del puntero de búsqueda es un valor de desplazamiento negativo.

Requisitos

Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceUnitsStream

WPD_STREAM_UNITS