Función PeerCollabEnumObjects (p2p.h)

La función PeerCollabEnumObjects devuelve el identificador a una enumeración que contiene los objetos del mismo nivel asociados con el punto de conexión de un mismo nivel específico.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumObjects(
  [in]           PCPEER_ENDPOINT pcEndpoint,
  [in, optional] const GUID      *pObjectId,
  [out]          HPEERENUM       *phPeerEnum
);

Parámetros

[in] pcEndpoint

Puntero a una estructura de PEER_ENDPOINT que contiene la información del punto de conexión de un mismo nivel cuyos objetos se enumerarán.

Si este parámetro es NULL , se devuelven los objetos publicados de los contactos del mismo nivel local.

[in, optional] pObjectId

Puntero a un valor GUID que identifica de forma única un objeto del mismo nivel con el elemento del mismo nivel proporcionado. Si se proporciona este parámetro, el único objeto del mismo nivel devuelto es el que coincide con este GUID.

[out] phPeerEnum

Puntero al identificador del conjunto enumerado de objetos del mismo nivel que corresponden al GUID devuelto en pObjectId. Pase este identificador a PeerGetNextItem para obtener cada elemento del conjunto enumerado.

Valor devuelto

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

Código devuelto	Descripción
E_OUTOFMEMORY	No hay suficiente memoria para admitir esta operación.
E_INVALIDARG	Uno de los argumentos no es válido.
PEER_E_NOT_INITIALIZED	La infraestructura del mismo nivel de Windows no se inicializa. Se requiere llamar a la función de inicialización pertinente.
PEER_E_NOT_SIGNED_IN	La operación requiere que el usuario inicie sesión.

Comentarios

Los objetos del mismo nivel son elementos de datos en tiempo de ejecución asociados a una aplicación determinada, como una imagen, un avatar, un certificado o una descripción específica. Cada objeto del mismo nivel debe tener un tamaño inferior a 16 0000.

PeerCollabEnumObjects devolverá todos los objetos publicados para el mismo nivel local. Más de una aplicación puede publicar los objetos.

Para obtener los objetos del mismo nivel individuales, pase el identificador devuelto a PeerGetNextItem. Los objetos del mismo nivel se devuelven como una matriz de punteros a las estructuras PEER_OBJECT . Si el punto de conexión no publica ningún objeto, se devolverá una matriz vacía. Para cerrar la enumeración y liberar los recursos asociados, pase este identificador a PeerEndEnumeration. Los elementos individuales devueltos por la enumeración deben liberarse con PeerFreeData.

Para obtener un objeto del mismo nivel correctamente:

• El punto de conexión debe haberse obtenido previamente llamando a PeerCollabEnumEndpoints.
• El mismo nivel local debe haberse suscrito al punto de conexión llamando a PeerCollabSubscribeEndpointData.
• Los datos del punto de conexión deben actualizarse llamando a PeerCollabRefreshEndpointData correctamente.

Si el usuario publica una imagen, la imagen se puede obtener recuperando el objeto correspondiente. El GUID del objeto de imagen se PEER_COLLAB_OBJECTID_USER_PICTURE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2P.lib
Archivo DLL	P2P.dll

Consulte también

PEER_CONTACT

PEER_ENDPOINT

PEER_OBJECT

Funciones de API de colaboración del mismo nivel