Compartir a través de

Función PeerGroupCreate (p2p.h)

  • Artículo

La función PeerGroupCreate crea un nuevo grupo del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

Parámetros

[in] pProperties

Puntero a una estructura de PEER_GROUP_PROPERTIES que especifica los detalles específicos del grupo, como los nombres de grupo del mismo nivel, las duraciones de invitación y las duraciones de presencia. Este parámetro es obligatorio.

Se deben establecer los siguientes miembros:

  • pwzCreatorPeerName

No se pueden establecer los siguientes miembros:

  • pwzGroupPeerName
Los miembros restantes son opcionales.

[out] phGroup

Devuelve el puntero de identificador al grupo del mismo nivel. Cualquier función llamada con este identificador como parámetro tiene la acción correspondiente realizada en ese grupo del mismo nivel. 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 para realizar la operación especificada.
PEER_E_CLOUD_NAME_AMBIGUOUS
 La nube especificada en pProperties no se puede detectar de forma única (más de una nube coincide con el nombre proporcionado).
PEER_E_INVALID_CLASSIFIER
 El clasificador de grupo del mismo nivel especificado en pProperties no es válido.
PEER_E_INVALID_PEER_NAME
 El nombre del mismo nivel especificado para el grupo en pProperties no es válido.
PEER_E_INVALID_PROPERTIES
 Una o varias de las propiedades del grupo del mismo nivel proporcionadas en pProperties no son válidas .
PEER_E_NO_CLOUD
 No se puede encontrar la nube especificada en pProperties .
PEER_E_NO_KEY_ACCESS
 Se deniega el acceso a las claves de identidad o grupo. 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 restablece manualmente.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY
 La contraseña especificada no cumple los requisitos de contraseña del sistema.
ERROR_DELETE_PENDING
 La identidad del mismo nivel especificada como creador del grupo se ha eliminado o está en proceso de eliminación.
 

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

El creador del grupo debe llamar a PeerGroupConnect inmediatamente después de la creación. Si esto no tiene lugar, los usuarios con una invitación llamarán a PeerGroupConnect correctamente, pero no podrán escuchar y finalmente recibirán el evento de error de conexión.

Una aplicación obtiene una identidad llamando a PeerIdentityCreate, o cualquier otro método que devuelva una cadena de nombre de identidad. Esta identidad actúa como propietario del grupo y es el miembro inicial del grupo del mismo nivel cuando se crea.

En el caso de las aplicaciones que usan contraseñas, se recomienda que las contraseñas se controlan de forma segura mediante una llamada a las funciones CryptoProtectMemory y SecureZeroMemory .

Requisitos

Requisito Value
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

PEER_GROUP_PROPERTIES

PeerGroupClose

PeerGroupConnect

PeerGroupOpen