Funciones de API de agrupación

Artículo
06/13/2023

La API de agrupación usa las siguientes funciones:

Funciones de inicialización y limpieza de grupos

Función	Descripción
PeerGroupShutdown	Cierra un grupo del mismo nivel creado con PeerGroupStartup y elimina los recursos asignados.
PeerGroupStartup	Inicia un grupo del mismo nivel mediante una versión solicitada de la infraestructura del mismo nivel.

Funciones de creación y acceso de grupos

Función	Descripción
PeerGroupClose	Invalida el identificador del grupo del mismo nivel obtenido por una llamada anterior a la función PeerGroupCreate, PeerGroupJoin o PeerGroupOpen .
PeerGroupConnect	Inicia una búsqueda PNRP para un grupo del mismo nivel e intenta conectarse a él. Una vez que se llama correctamente a esta función, un elemento del mismo nivel puede comunicarse con otros miembros del grupo del mismo nivel.
PeerGroupConnectByAddress	Intenta conectarse al grupo del mismo nivel en el que participan otros elementos del mismo nivel con direcciones IPv6 conocidas.
PeerGroupCreate	Crea un nuevo grupo del mismo nivel.
PeerGroupCreateInvitation	Devuelve una cadena XML que el elemento del mismo nivel especificado puede usar para unirse a un grupo.
PeerGroupCreatePasswordInvitation	Devuelve una cadena XML que el elemento del mismo nivel especificado puede usar para unir un grupo con una contraseña coincidente.
PeerGroupDelete	Elimina los datos locales y el certificado asociados a un grupo del mismo nivel.
PeerGroupGetStatus	Recupera el estado actual de un grupo.
PeerGroupIssueCredentials	Emite credenciales, incluido un GMC, a una identidad específica y, opcionalmente, devuelve una cadena XML de invitación que el elemento del mismo nivel puede usar para unirse a un grupo del mismo nivel.
PeerGroupJoin	Permite que un elemento del mismo nivel con una invitación se una a un grupo del mismo nivel existente.
PeerGroupOpen	Abre un grupo del mismo nivel que un elemento del mismo nivel ha creado o unido.
PeerGroupParseInvitation	Devuelve una estructura PEER_INVITATION_INFO con los detalles de una invitación específica.
PeerGroupPasswordJoin	Permite que un elemento del mismo nivel con una invitación y la contraseña correcta se unan a un grupo del mismo nivel protegido por contraseña.

Funciones de información de grupos y miembros

Función	Descripción
PeerGroupEnumMembers	Crea una enumeración de los miembros del grupo del mismo nivel disponibles y la información de pertenencia asociada.
PeerGroupGetProperties	Recupera información sobre las propiedades de un grupo especificado.
PeerGroupSetProperties	Establece las propiedades del grupo del mismo nivel actuales. En la versión 1.0 de esta API, solo el creador del grupo del mismo nivel puede realizar esta operación.

Funciones de administración de registros y registros

Función	Descripción
PeerGroupAddRecord	Agrega un nuevo registro al grupo del mismo nivel, que se propaga a todos los elementos del mismo nivel participantes.
PeerGroupDeleteRecord	Elimina un registro de un grupo del mismo nivel. Solo el creador de un registro puede eliminarlo.
PeerGroupEnumRecords	Crea una enumeración de registros de grupo del mismo nivel.
PeerGroupGetRecord	Recupera un registro de grupo específico.
PeerGroupSearchRecords	Busca registros que coincidan con los criterios proporcionados en la base de datos del grupo del mismo nivel local.
PeerGroupUpdateRecord	Novedades un registro dentro de un grupo del mismo nivel específico.

Funciones de importación y exportación de bases de datos de grupo

Función	Descripción
PeerGroupExportDatabase	Exporta una base de datos de grupo del mismo nivel a un archivo específico, que se puede transportar a otro equipo e importarse con la función PeerGroupImportDatabase .
PeerGroupImportDatabase	Importa una base de datos de grupo del mismo nivel desde un archivo local.

Funciones de conexión directa

Función	Descripción
PeerGroupCloseDirectConnection	Cierra una conexión directa específica entre dos elementos del mismo nivel.
PeerGroupEnumConnections	Crea una enumeración de conexiones actualmente activas en el mismo nivel.
PeerGroupOpenDirectConnection	Establece una conexión directa con otro elemento del mismo nivel en un grupo del mismo nivel.
PeerGroupSendData	Envía datos a un miembro a través de un vecino o una conexión directa.

Infraestructura de eventos de grupo

Función	Descripción
PeerGroupGetEventData	Permite que una aplicación recupere los datos devueltos por un evento de agrupación.
PeerGroupRegisterEvent	Registra un elemento del mismo nivel para eventos específicos del grupo del mismo nivel.
PeerGroupUnregisterEvent	Anula el registro de un elemento del mismo nivel de notificación de eventos del mismo nivel asociados al identificador de eventos proporcionado.

Funciones de conversión de tiempo de grupo

Función	Descripción
PeerGroupPeerTimeToUniversalTime	Convierte el valor de tiempo de referencia mantenido por el grupo del mismo nivel en un valor de hora localizado adecuado para mostrarse en un equipo del mismo nivel.
PeerGroupUniversalTimeToPeerTime	Convierte un valor de hora local del equipo del mismo nivel en un valor de tiempo común del grupo del mismo nivel.

Funciones de configuración de grupo

Función	Descripción
PeerGroupExportConfig	Exporta la configuración de grupo para un elemento del mismo nivel como una cadena XML que contiene la identidad, el nombre del grupo y el GMC para la identidad.
PeerGroupImportConfig	Importa una configuración de grupo del mismo nivel para una identidad basada en la configuración específica de una cadena de configuración XML proporcionada.