Función PeerCollabSetPresenceInfo (p2p.h)

  • Artículo

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