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

Artigo
08/25/2023

O método SeekInUnits executa uma busca em um fluxo, com base em unidades alternativas.

Sintaxe

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

Parâmetros

[in] dlibMove

O deslocamento a ser adicionado ao local indicado pelo parâmetro dwOrigin . As unidades para o deslocamento são especificadas por unidades. Se dwOrigin for STREAM_SEEK_SET, isso será interpretado como um valor não assinado em vez de um valor assinado.

[in] units

As unidades dos parâmetros dlibMove e plibNewPosition . Consulte WPD_STREAM_UNITS para obter mais detalhes.

[in] dwOrigin

A origem do deslocamento especificado em dlibMove. A origem pode ser o início do arquivo (STREAM_SEEK_SET), o ponteiro de busca atual (STREAM_SEEK_CUR) ou o final do arquivo (STREAM_SEEK_END). Para obter mais informações sobre valores, consulte a enumeração STREAM_SEEK .

[out, optional] plibNewPosition

Um ponteiro para o local em que esse método grava o valor do novo ponteiro de busca desde o início do fluxo. As unidades são fornecidas por unidades. Você pode definir esse ponteiro como NULL. Nesse caso, esse método não fornece o novo ponteiro de busca.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O ponteiro de busca foi ajustado com êxito.
STG_E_INVALIDPOINTER	Indica que o parâmetro [out] plibNewPosition aponta para memória inválida, porque plibNewPosition não é lido.
STG_E_INVALIDFUNCTION	O parâmetro dwUnits ou dwOrigin contém um valor inválido ou o parâmetro dlibMove contém um valor de deslocamento inválido. Por exemplo, o resultado do ponteiro seek é um valor de deslocamento negativo.

Requisitos


Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceUnitsStream

WPD_STREAM_UNITS

Compartilhar via