Función PeerCollabSignin (p2p.h)

  • Artículo

La función PeerCollabSignin firma el elemento del mismo nivel en un proveedor de presencia de red de colaboración del mismo nivel hospedado (presencia sin servidor) o subred ("Personas Cerca de mí").

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSignin(
  [in] HWND  hwndParent,
  [in] DWORD dwSigninOptions
);

Parámetros

[in] hwndParent

Identificador de Windows para el inicio de sesión de la aplicación primaria.

[in] dwSigninOptions

PEER_SIGNIN_FLAGS valor de enumeración que contiene las opciones de inicio de sesión del proveedor de presencia para el elemento 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 aplicación no realizó una llamada anterior a PeerCollabStartup.
PEER_E_SERVICE_NOT_AVAILABLE
 Se intentó llamar a PeerCollabSignIn desde un proceso con privilegios elevados.
PEER_S_NO_CONNECTIVITY
 El inicio de sesión se realizó correctamente, pero las direcciones IPv6 no están disponibles en este momento.

Comentarios

Si el servicio p2phost.exe no se está ejecutando, esta función la iniciará.

Si se intenta iniciar el servicio p2phost.exe desde un proceso con privilegios elevados, se devuelve un error. Como resultado, una aplicación no puede poner en peligro la seguridad concediéndole privilegios administrativos por error a p2phost.exe. No es posible iniciar p2phost.exe en un modo no interactivo, ya que necesita mostrar cuadros de diálogo de Windows para las invitaciones entrantes.

Al llamar a PeerCollabSignin se muestra una interfaz de usuario de inicio de sesión si el usuario no ha autorizado el inicio de sesión automático. Si se especifica hwndParent , la ventana de la interfaz de usuario usará hwndParent como la ventana primaria.

Cuando un usuario inicia sesión en "Personas Near Me", el nombre para mostrar del usuario, el nombre del equipo y la dirección IP se publican en elementos del mismo nivel de la subred. Opcionalmente, el usuario puede especificar una imagen para mostrar para su publicación. Esta información no se publica si no se llama a PeerCollabSignin o el usuario cierra la sesión.

Una vez que haya iniciado sesión, el usuario puede ver una lista de elementos del mismo nivel que ha iniciado sesión en la subred y está disponible para la interacción. Esta lista estará vacía si nadie más ha iniciado sesión en "Personas Near Me" en la subred.

Varias aplicaciones pueden usar la infraestructura en cualquier momento dado. No se recomienda que una sola aplicación llame a PeerCollabSignout, ya que otras aplicaciones no podrán usar la infraestructura. Las aplicaciones también deben estar preparadas para controlar el inicio de sesión y cierre de sesión del usuario, o situaciones en las que una máquina entra en suspensión o hibernación.

La función PeerCollabSignin requiere actualmente hasta dos segundos para completarse.

Los nombres para mostrar no son necesariamente únicos. Los usuarios deben comprobar la identidad de la persona que usa un nombre para mostrar por correo electrónico, teléfono o en persona antes de aceptar una invitación para interactuar.

Para cerrar la sesión de una red colaborativa del mismo nivel, llame a PeerCollabSignout con el mismo conjunto de opciones de inicio de sesión. Un usuario también puede cerrar sesión a través de la interfaz de usuario.

Requisitos

   
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_SIGNIN_FLAGS

Funciones de API de colaboración del mismo nivel

PeerCollabGetSigninOptions

PeerCollabSignOut