estructura PEER_GRAPH_PROPERTIES (p2p.h)
La estructura de PEER_GRAPH_PROPERTIES contiene datos sobre la directiva de un grafo del mismo nivel, identificador, ámbito y otra información.
Sintaxis
typedef struct peer_graph_properties_tag {
DWORD dwSize;
DWORD dwFlags;
DWORD dwScope;
DWORD dwMaxRecordSize;
PWSTR pwzGraphId;
PWSTR pwzCreatorId;
PWSTR pwzFriendlyName;
PWSTR pwzComment;
ULONG ulPresenceLifetime;
ULONG cPresenceMax;
} PEER_GRAPH_PROPERTIES, *PPEER_GRAPH_PROPERTIES;
Miembros
dwSize
Especifica el tamaño, en bytes, de esta estructura de datos. El miembro dwSize debe establecerse en el tamaño de PEER_GRAPH_PROPERTIES antes de llamar a PeerGraphCreate. Este miembro es obligatorio. No hay un valor predeterminado.
dwFlags
Marcas que controlan el comportamiento de un elemento del mismo nivel en un gráfico. El valor predeterminado no tiene marcas establecidas. El valor válido se identifica en la tabla siguiente.
| Valor | Descripción |
|---|---|
| PEER_GRAPH_PROPERTY_DEFER_EXPIRATION | Especifica cuándo expirar un registro de grafo. Cuando un gráfico no está conectado y se establece esta marca, la expiración no se produce hasta que el gráfico se conecta al menos a otro miembro. |
dwScope
Especifica el ámbito en el que se publica el identificador del grafo del mismo nivel. El valor predeterminado es global. Los valores válidos se identifican en la tabla siguiente.
| Valor | Descripción |
|---|---|
| PEER_GRAPH_SCOPE_GLOBAL | El ámbito incluye Internet. |
| PEER_GRAPH_SCOPE_LINK_LOCAL | El ámbito está restringido a una subred local. |
| PEER_GRAPH_SCOPE_SITE_LOCAL | El ámbito está restringido a un sitio, por ejemplo, una intranet corporativa. |
dwMaxRecordSize
Especifica el valor que indica el registro más grande que se puede agregar a un gráfico del mismo nivel. Un valor válido es cero (0), que indica que se usa el tamaño máximo de registro predeterminado (60 megabytes) y cualquier valor entre 1024 bytes y 60 megabytes.
pwzGraphId
Especifica el identificador único de un gráfico del mismo nivel. Este identificador debe ser único para el par de equipos o usuarios. Este miembro es obligatorio y no tiene ningún valor predeterminado. Si el valor de cadena es mayor que 256 caracteres (incluido el terminador null), se devuelve un error.
pwzCreatorId
Especifica el identificador único para el creador de un grafo del mismo nivel. Este miembro es obligatorio y no tiene ningún valor predeterminado. Si el valor de cadena es mayor que 256 caracteres (incluido el terminador null), se devuelve un error.
pwzFriendlyName
Especifica el nombre descriptivo de un gráfico del mismo nivel. Este miembro es opcional y puede ser NULL. El valor predeterminado es NULL. La longitud máxima de esta cadena es de 256 caracteres, incluido el terminador null.
pwzComment
Especifica el comentario usado para describir un gráfico del mismo nivel. Este miembro es opcional y puede ser NULL. El valor predeterminado es NULL. La longitud máxima de esta cadena es de 512 caracteres, incluido el terminador null.
ulPresenceLifetime
Especifica el número de segundos antes de que expire un registro de presencia. El valor predeterminado es 300 segundos (5 minutos). No establezca el valor de ulPresenceLifetime en menos de 300 segundos. Si este miembro se establece menos que el valor predeterminado 300 (5 minutos), se puede producir un comportamiento indefinido.
cPresenceMax
Especifica cuántos registros de presencia mantiene la infraestructura del mismo nivel en un gráfico del mismo nivel a la vez. Todos los demás nodos con PeerGraphEnumNodes pueden enumerar un nodo que tenga su presencia publicada. Especifique cómo se publican los registros de presencia para los usuarios especificando uno de los valores identificados en la tabla siguiente.
| Valor | Descripción |
|---|---|
| -1 | Los registros de presencia se publican automáticamente para todos los usuarios. |
| 0 | Los registros de presencia no se publican automáticamente. |
| 1-N | Se publican hasta N registros de presencia al mismo tiempo. La infraestructura de grafos del mismo nivel elige aleatoriamente los registros de presencia que se publican. |
Comentarios
Una aplicación puede forzar que peer Graphing Infrastructure publique información de presencia mediante PeerGraphSetPresence.
Solo se pueden actualizar campos específicos del PEER_GRAPH_PROPERTIES al llamar a PeerGraphSetProperties. Se pueden actualizar los miembros siguientes:
- pwzFriendlyName
- pwzComment
- ulPresenceLifetime
- cPresenceMax
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 |
| Encabezado | p2p.h |