Função PeerGetNextItem (p2p.h)

Artigo
03/01/2024

A função PeerGetNextItem retorna um número específico de itens de uma enumeração par.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGetNextItem(
  [in]      HPEERENUM hPeerEnum,
  [in, out] ULONG     *pCount,
  [out]     PVOID     **pppvItems
);

Parâmetros

[in] hPeerEnum

Manipule para a enumeração par da qual os itens são recuperados. Esse identificador é gerado por uma função de enumeração par.

[in, out] pCount

Ponteiro para um inteiro que especifica o número de itens a serem recuperados da enumeração par. Quando retornado, ele contém o número de itens em ppvItems. Esse parâmetro não pode ser NULL.

[out] pppvItems

Recebe um ponteiro para uma matriz de ponteiros para os próximos itens pCount na enumeração par. Os dados, por exemplo, um bloco de informações de registro ou membro, dependem do tipo real de enumeração par.

Retornar valor

Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Código de retorno	Descrição
E_INVALIDARG	Um dos parâmetros não é válido.
E_OUTOFMEMORY	Não há memória suficiente para executar uma operação especificada.

Comentários

A função PeerGetNextItem retorna o seguinte:

Itens iguais ou menores que o valor especificado em pCount.
Uma lista de itens que são menores que o valor especificado quando o valor é maior que o número de itens disponíveis.

Nota Por exemplo, quando o valor de entrada de pCount é 10 e o restante da enumeração é de 5 itens, apenas 5 itens são retornados e o valor apontado por pCount é definido como 5.

Todos os itens retornados devem ser liberados passando um ponteiro para a matriz de ponteiros para a função PeerFreeData .

O final de uma enumeração é indicado quando a função retorna com o parâmetro pCount definido como zero (0).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	p2p.h
Biblioteca	P2P.lib
DLL	P2P.dll