Función PeerCollabSetObject (p2p.h)
La función PeerCollabSetObject crea o actualiza un objeto de datos del mismo nivel que se usa en una red de colaboración del mismo nivel.
Sintaxis
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
[in] PCPEER_OBJECT pcObject
);
Parámetros
[in] pcObject
Puntero a una estructura de PEER_OBJECT que contiene el objeto del mismo nivel en la red de colaboración del mismo nivel.
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 |
|---|---|
|
No hay suficiente memoria para admitir esta operación. |
|
Uno de los argumentos no es válido. |
|
La infraestructura del mismo nivel de Windows no se inicializa. Se requiere llamar a la función de inicialización pertinente. |
|
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 K y no puede ser 0.
Si ya se ha publicado un objeto, PeerCollabSetObject actualizará los datos del objeto existentes. La última aplicación que actualiza el objeto tomará posesión del objeto. Como resultado, si la aplicación finaliza el objeto se elimina.
Si se quita el estado "publicado" de un objeto debido al cierre de sesión en lugar del cierre de la aplicación asociada, la aplicación es responsable de publicar el objeto la próxima vez que el usuario inicie sesión.
Los contactos de confianza que ven este objeto del mismo nivel tendrán un evento de PEER_EVENT_OBJECT_CHANGED generado localmente, lo que indica el cambio en el estado de este objeto del mismo nivel.
PeerCollabSetObject se puede usar para publicar como máximo 128 objetos.
Hay un objeto con un GUID determinado publicado en un momento dado.
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 |