Función PeerCollabSetPresenceInfo (p2p.h)

La función PeerCollabSetPresenceInfo actualiza la información de presencia del autor de la llamada a los contactos que lo ven.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
  [in] PCPEER_PRESENCE_INFO pcPresenceInfo
);

Parámetros

[in] pcPresenceInfo

Puntero a una estructura de PEER_PRESENCE_INFO que contiene la nueva información de presencia que se va a publicar para la aplicación del mismo nivel que llama.

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 contactos que ven la presencia de este mismo nivel tendrán un evento de PEER_EVENT_PRESENCE_CHANGED generado localmente que señale el cambio del mismo nivel en estado de presencia. El estado de presencia de un mismo nivel no se puede establecer en sin conexión mientras ha iniciado sesión. De forma predeterminada, el estado de presencia de un mismo nivel es "en línea" y el texto descriptivo es NULL al iniciar sesión.

Cualquier texto descriptivo para el estado de presencia está limitado a 255 caracteres Unicode.

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

Funciones de API de colaboración del mismo nivel