Compartir a través de

Función PeerGroupOpen (p2p.h)

  • Artículo

La función PeerGroupOpen abre un grupo del mismo nivel que un elemento del mismo nivel ha creado o unido. Una vez abierto un grupo del mismo nivel, el mismo nivel puede registrarse para recibir notificaciones de eventos.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpen(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzGroupPeerName,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Parámetros

[in] pwzIdentity

Puntero a una cadena Unicode que contiene la identidad que usa el mismo nivel para abrir un grupo. Este parámetro es obligatorio.

[in] pwzGroupPeerName

Puntero a una cadena Unicode que contiene el nombre del mismo nivel del grupo del mismo nivel. Este parámetro es obligatorio.

[in] pwzCloud

Puntero a una cadena Unicode que contiene el nombre de la nube PNRP en la que se encuentra el grupo del mismo nivel. Si el valor es NULL, se usa la nube especificada en las propiedades del grupo del mismo nivel.

[out] phGroup

Puntero a un identificador para un grupo del mismo nivel. Si este valor es NULL, la operación de apertura no se realiza correctamente. 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_CLOUD_NAME_AMBIGUOUS
 La nube especificada en pwzCloud no se puede detectar de forma única, por ejemplo, más de una nube coincide con el nombre proporcionado.
PEER_E_NO_CLOUD
 No se puede encontrar la nube especificada en pwzCloud .
PEER_E_NO_KEY_ACCESS
 Se deniega el acceso a la identidad del mismo nivel o a las claves del grupo del mismo nivel. Normalmente, esto se debe 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

Varias aplicaciones pueden abrir simultáneamente el mismo grupo. Cualquier aplicación puede optar por abrir un grupo sin llamar posteriormente a PeerGroupConnect. Estas aplicaciones se consideran sin conexión. Sin embargo, una segunda aplicación puede abrir y conectar el elemento del mismo nivel al grupo, lo que significa que una aplicación debe estar lista para conectarse en cualquier momento.

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

Consulte también

PeerGroupClose

PeerGroupConnect

PeerGroupCreate

PeerGroupJoin