estrutura PEER_RECORD (p2p.h)

Artigo
03/15/2023

A estrutura PEER_RECORD contém o objeto de registro que um aplicativo usa.

Sintaxe

typedef struct peer_record_tag {
  DWORD     dwSize;
  GUID      type;
  GUID      id;
  DWORD     dwVersion;
  DWORD     dwFlags;
  PWSTR     pwzCreatorId;
  PWSTR     pwzModifiedById;
  PWSTR     pwzAttributes;
  FILETIME  ftCreation;
  FILETIME  ftExpiration;
  FILETIME  ftLastModified;
  PEER_DATA securityData;
  PEER_DATA data;
} PEER_RECORD, *PPEER_RECORD;

Membros

dwSize

Especifica o tamanho de uma estrutura. Defina o valor como sizeof(PEER_RECORD).

type

Especifica o tipo de registro. O tipo é um GUID que um aplicativo deve especificar. O GUID representa um tipo de registro exclusivo, por exemplo, um registro de chat.

id

Especifica a ID exclusiva de um registro. A Infraestrutura de Pares fornece essa ID. Esse parâmetro é ignorado em chamadas para PeerGroupAddRecord. Um aplicativo não pode modificar esse membro.

dwVersion

Especifica a versão de um registro que a Infraestrutura de Pares fornece quando um aplicativo chama PeerGraphAddRecord ou PeerGraphUpdateRecord. Um aplicativo não pode modificar esse membro.

dwFlags

Especifica os sinalizadores que indicam processamento especial, que deve ser aplicado a um registro. A tabela a seguir identifica os valores válidos.

Valor	Descrição
PEER_RECORD_FLAG_AUTOREFRESH	Indica que um registro é atualizado automaticamente quando está pronto para expirar.
PEER_RECORD_FLAG_DELETED	Indica que um registro é marcado como excluído.

Nota Um aplicativo não pode definir esses sinalizadores.

pwzCreatorId

Ponteiro para a ID exclusiva de um criador de registro. Esse membro é definido como NULL para chamadas para PeerGraphAddRecord e PeerGraphUpdateRecord. Um aplicativo não pode definir esse membro.

pwzModifiedById

Especifica a ID exclusiva da última pessoa que altera um registro. Um aplicativo não pode definir esse membro.

pwzAttributes

Ponteiro para o conjunto de pares de nome de atributo e valor associados a um registro. Esse membro aponta para uma cadeia de caracteres XML. Os atributos de registro são especificados como uma cadeia de caracteres XML e devem ser consistentes com o esquema de atributo de registro de infraestrutura de par. Para obter uma explicação completa do esquema XML, consulte Esquema de atributo de registro.

A Infraestrutura de Pares reserva vários nomes de atributo que um usuário não pode definir. A lista a seguir identifica os nomes de atributo reservados:

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
peercreationtime
peerlastmodificationtime

ftCreation

Especifica o UTC (Tempo Universal Coordenado) que um registro é criado. A Infraestrutura de Pares fornece esse valor e o valor é definido como zero (0) em chamadas para PeerGroupAddRecord. Um aplicativo não pode definir esse membro.

ftExpiration

A hora UTC em que um registro expira. Esse membro é necessário. Ele pode ser atualizado para um valor de tempo maior que o valor de tempo especificado originalmente, mas não pode ser menor que o valor especificado originalmente.

Nota Se dwFlags estiver definido como PEER_RECORD_FLAG_AUTOREFRESH, não defina o valor de ftExpiration para menos de quatro (4) minutos. Se esse membro for definido como menos de quatro (4) minutos, poderá ocorrer um comportamento indefinido.

ftLastModified

A hora UTC em que um registro é modificado. A Infraestrutura de Pares fornece esse valor. Defina esse membro como NULL ao chamar PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord e PeerGroupUpdateRecord. Um aplicativo não pode definir esse membro.

securityData

Especifica os dados de segurança contidos em uma estrutura de PEER_DATA . A API do Graphing usa esse membro e fornece ao provedor de segurança um local para armazenar dados de segurança, por exemplo, uma assinatura. A API de Agrupamento não pode modificar esse membro.

data

Especifica os dados reais que esse registro contém.

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