Compartir a través de

Función PeerGroupStartup (p2p.h)

  • Artículo

La función PeerGroupStartup inicia un grupo del mismo nivel mediante una versión solicitada de la infraestructura del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
  [in]  WORD               wVersionRequested,
  [out] PPEER_VERSION_DATA pVersionData
);

Parámetros

[in] wVersionRequested

Especifica la versión más alta de la infraestructura del mismo nivel que un llamador puede admitir. El byte de orden alto especifica el número de versión secundaria (revisión). El byte de orden bajo especifica el número de versión principal Este parámetro es necesario.

[out] pVersionData

Puntero a una estructura de PEER_VERSION_DATA que contiene el nivel de compatibilidad específico proporcionado por la infraestructura del mismo nivel. Este parámetro es obligatorio.

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
ERROR_SERVICE_DEPENDENCY_FAIL
 El servicio Peer Name Resolution Protocol (PNRP) debe iniciarse antes de llamar a PeerGroupStartup.
E_OUTOFMEMORY
 No hay suficiente memoria disponible para completar la operación.
PEER_E_IPV6_NOT_INSTALLED
 No se pudo iniciar el servicio de agrupación porque IPv6 no está instalado en el equipo.
PEER_E_UNSUPPORTED_VERSION
 El subsistema del mismo nivel instalado no admite la versión solicitada.
 

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 servicio Del Protocolo de resolución de nombres del mismo nivel (PNRP) debe iniciarse antes de llamar a esta función.

La aplicación llama a esta función antes de llamar a cualquier otra función de agrupación del mismo nivel.

Para esta versión, las aplicaciones deben usar PEER_GROUP_VERSION como versión solicitada.

Un grupo del mismo nivel iniciado con esta función se cierra llamando a PeerGroupShutdown cuando finaliza la aplicación.

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

Funciones de API de agrupación

PEER_VERSION_DATA

PeerGroupShutdown