estrutura PEER_GRAPH_PROPERTIES (p2p.h)
A estrutura PEER_GRAPH_PROPERTIES contém dados sobre a política de um grafo par, ID, escopo e outras informações.
Sintaxe
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;
Membros
dwSize
Especifica o tamanho, em bytes, dessa estrutura de dados. O membro dwSize deve ser definido com o tamanho de PEER_GRAPH_PROPERTIES antes de chamar PeerGraphCreate. Esse membro é necessário. Não há um valor padrão.
dwFlags
Sinalizadores que controlam o comportamento de um par em um grafo. O padrão é que não tem sinalizadores definidos. O valor válido é identificado na tabela a seguir.
| Valor | Descrição |
|---|---|
| PEER_GRAPH_PROPERTY_DEFER_EXPIRATION | Especifica quando expirar um registro de grafo. Quando um grafo não está conectado e esse sinalizador é definido, a expiração não ocorre até que o grafo se conecte a pelo menos um outro membro. |
dwScope
Especifica o escopo no qual a ID do grafo par é publicada. O valor padrão é global. Os valores válidos são identificados na tabela a seguir.
| Valor | Descrição |
|---|---|
| PEER_GRAPH_SCOPE_GLOBAL | O escopo inclui a Internet. |
| PEER_GRAPH_SCOPE_LINK_LOCAL | O escopo é restrito a uma sub-rede local. |
| PEER_GRAPH_SCOPE_SITE_LOCAL | O escopo é restrito a um site, por exemplo, uma intranet corporativa. |
dwMaxRecordSize
Especifica o valor que indica o maior registro que pode ser adicionado a um grafo par. Um valor válido é zero (0), que indica que o tamanho máximo padrão do registro é usado (60 megabytes) e qualquer valor entre 1024 bytes e 60 megabytes.
pwzGraphId
Especifica o identificador exclusivo para um grafo par. Essa ID deve ser exclusiva para o par computador/usuário. Esse membro é necessário e não tem nenhum valor padrão. Se o valor da cadeia de caracteres for maior que 256 caracteres (incluindo o terminador nulo), um erro será retornado.
pwzCreatorId
Especifica o identificador exclusivo para o criador de um grafo par. Esse membro é necessário e não tem nenhum valor padrão. Se o valor da cadeia de caracteres for maior que 256 caracteres (incluindo o terminador nulo), um erro será retornado.
pwzFriendlyName
Especifica o nome amigável de um grafo par. Esse membro é opcional e pode ser NULL. O valor padrão é NULL. O comprimento máximo dessa cadeia de caracteres é de 256 caracteres, incluindo o terminador nulo.
pwzComment
Especifica o comentário usado para descrever um grafo par. Esse membro é opcional e pode ser NULL. O valor padrão é NULL. O comprimento máximo dessa cadeia de caracteres é de 512 caracteres, incluindo o terminador nulo.
ulPresenceLifetime
Especifica o número de segundos antes que um registro de presença expire. O valor padrão é 300 segundos (5 minutos). Não defina o valor de ulPresenceLifetime como menos de 300 segundos. Se esse membro for definido como menor que o valor padrão de 300 (5 minutos), poderá ocorrer um comportamento indefinido.
cPresenceMax
Especifica quantos registros de presença a Infraestrutura de Pares mantém em um grafo par ao mesmo tempo. Um nó que tem sua presença publicada pode ser enumerado por todos os outros nós com PeerGraphEnumNodes. Especifique como os registros de presença dos usuários são publicados especificando um dos valores identificados na tabela a seguir.
| Valor | Descrição |
|---|---|
| -1 | Os registros de presença são publicados automaticamente para todos os usuários. |
| 0 | Os registros de presença não são publicados automaticamente. |
| 1-N | Até N número de registros de presença são publicados ao mesmo tempo. Os registros de presença publicados são escolhidos aleatoriamente pela Infraestrutura de Grafo de Pares. |
Comentários
Um aplicativo pode forçar a Infraestrutura de Grafo de Pares a publicar informações de presença usando PeerGraphSetPresence.
Somente campos específicos no PEER_GRAPH_PROPERTIES podem ser atualizados ao chamar PeerGraphSetProperties. Os seguintes membros podem ser atualizados:
- pwzFriendlyName
- pwzComment
- ulPresenceLifetime
- cPresenceMax
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP |
| Servidor mínimo com suporte | Nenhum compatível |
| Cabeçalho | p2p.h |