Compartilhar via


IEnumItemIds::Next

Quando substituído em uma classe derivada, retorna o próximo elemento na lista de ID de item, se estiver disponível.

HRESULT Next(
  BYTE * pbItemId,
  DWORD * pcbItemIdSize);

Parâmetros

  • pbItemId
    [in, out, unique, size_is(*pcbItemIdSize)] A ID do próximo item da lista.
  • pcbItemIdSize
    [in, out] Especifica o número de bytes em pbItemId. Retorna o número de bytes necessários para recuperar a ID quando pbItemId for muito pequeno ou retorna o número de bytes gravados.

Valor de retorno

  • S_OK.

  • S_FALSE se não houver mais elementos para recuperar.

  • HRESULT_FROM_WIN32(ERROR_MORE_DATA) quando pbItemId for muito pequeno. Nessa situação, o número de bytes necessários é retornado em pcbItemIdSize.

  • Códigos de erro especificados pelo provedor.

Comentários

Na primeira vez que o Sync Framework chama esse método, ele especifica NULL para pbItemId e 0 para pcbItemIdSize. Nesse caso, a implementação deve retornar o tamanho correto para a ID de item em pcbItemIdSize e um código de erro de HRESULT_FROM_WIN32 (ERROR_MORE_DATA).

Consulte também

Referência

Interface IEnumItemIds