Función PeerGroupOpenDirectConnection (p2p.h)

Artículo
08/25/2023

La función PeerGroupOpenDirectConnection establece una conexión directa con otro elemento del mismo nivel en un grupo del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpenDirectConnection(
  [in]  HGROUP        hGroup,
  [in]  PCWSTR        pwzIdentity,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Parámetros

[in] hGroup

Identificador del grupo del mismo nivel que hospeda la conexión directa. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[in] pwzIdentity

Puntero a una cadena Unicode que contiene la identidad a la que se conecta un elemento del mismo nivel. Este parámetro es obligatorio.

[in] pAddress

Puntero a una estructura de PEER_ADDRESS que contiene la dirección IPv6 a la que se conecta el elemento del mismo nivel. Este parámetro es obligatorio.

[out] pullConnectionId

Entero de 64 bits sin signo que identifica la conexión directa. Este valor de identificador no se puede asumir como válido hasta que se genere el evento PEER_GROUP_EVENT_DIRECT_CONNECTION e indique que el otro elemento del mismo nivel ha aceptado la conexión. Este parámetro es obligatorio.

Valor devuelto

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

Código devuelto	Descripción
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria disponible para completar la operación.
PEER_E_CONNECT_SELF	Se produjo un error en la conexión porque era un bucle invertido, es decir, la conexión está entre un sistema del mismo nivel y otro.
PEER_E_NO_KEY_ACCESS	Se deniega el acceso a la identidad del mismo nivel o a las claves del grupo del mismo nivel. Esto suele deberse a una lista de control de acceso (ACL) incorrecta para la carpeta que contiene las claves de usuario o equipo. Esto puede ocurrir cuando la ACL se ha restablecido manualmente.

Los errores específicos de criptografía se pueden devolver desde el proveedor base RSA de Microsoft. Estos errores tienen el prefijo CRYPT_* y se definen en Winerror.h.

Comentarios

Cada conexión directa abierta con esta función debe cerrarse con PEER_GROUP_EVENT estructura DATA tiene el miembro de estado de su componente PEER_EVENT_CONNECTION_CHANGE_DATA estructura establecida en PEER_CONNECTION_FAILED.

Requisitos


Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2P.lib
Archivo DLL	P2P.dll