Función PeerGetNextItem (p2p.h)

Artículo
03/05/2024

La función PeerGetNextItem devuelve un número específico de elementos de una enumeración del mismo nivel.

Sintaxis

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

Parámetros

[in] hPeerEnum

Identificador de la enumeración del mismo nivel desde la que se recuperan los elementos. Este identificador lo genera una función de enumeración del mismo nivel.

[in, out] pCount

Puntero a un entero que especifica el número de elementos que se van a recuperar de la enumeración del mismo nivel. Cuando se devuelve, contiene el número de elementos en ppvItems. Este parámetro no puede ser NULL.

[out] pppvItems

Recibe un puntero a una matriz de punteros a los siguientes elementos pCount de la enumeración del mismo nivel. Los datos, por ejemplo, un bloque de información de registro o miembro, dependen del tipo de enumeración del mismo nivel real.

Valor devuelto

Devuelve S_OK si la operación se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.

Código devuelto	Descripción
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria para realizar una operación especificada.

Comentarios

La función PeerGetNextItem devuelve lo siguiente:

Elementos que son iguales o menores que la cantidad especificada en pCount.
Lista de elementos que son menores que la cantidad especificada cuando la cantidad es mayor que el número de elementos disponibles.

Nota Por ejemplo, cuando el valor entrante de pCount es 10 y el resto de la enumeración es 5 elementos, solo se devuelven 5 elementos y el valor al que apunta pCount se establece en 5.

Todos los elementos devueltos deben liberarse pasando un puntero a la matriz de punteros a la función PeerFreeData .

El final de una enumeración se indica cuando la función devuelve con el parámetro pCount establecido en cero (0).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2P.lib
Archivo DLL	P2P.dll