struttura PEER_RECORD (p2p.h)

Articolo
08/25/2023

La struttura PEER_RECORD contiene l'oggetto record utilizzato da un'applicazione.

Sintassi

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;

Members

dwSize

Specifica le dimensioni di una struttura. Impostare il valore su sizeof(PEER_RECORD).

type

Specifica il tipo di record. Il tipo è un GUID che un'applicazione deve specificare. Il GUID rappresenta un tipo di record univoco, ad esempio un record di chat.

id

Specifica l'ID univoco di un record. L'infrastruttura peer fornisce questo ID. Questo parametro viene ignorato nelle chiamate a PeerGroupAddRecord. Un'applicazione non può modificare questo membro.

dwVersion

Specifica la versione di un record fornito dall'infrastruttura peer quando un'applicazione chiama PeerGraphAddRecord o PeerGraphUpdateRecord. Un'applicazione non può modificare questo membro.

dwFlags

Specifica i flag che indicano un'elaborazione speciale, che deve essere applicata a un record. La tabella seguente identifica i valori validi.

Valore	Descrizione
PEER_RECORD_FLAG_AUTOREFRESH	Indica che un record viene aggiornato automaticamente quando è pronto per la scadenza.
PEER_RECORD_FLAG_DELETED	Indica che un record è contrassegnato come eliminato.

Nota Un'applicazione non può impostare questi flag.

pwzCreatorId

Puntatore all'ID univoco di un autore di record. Questo membro è impostato su NULL per le chiamate a PeerGraphAddRecord e PeerGraphUpdateRecord. Un'applicazione non può impostare questo membro.

pwzModifiedById

Specifica l'ID univoco dell'ultima persona che modifica un record. Un'applicazione non può impostare questo membro.

pwzAttributes

Puntatore al set di coppie nome attributo e valore associate a un record. Questo membro punta a una stringa XML. Gli attributi dei record vengono specificati come stringa XML e devono essere coerenti con lo schema dell'attributo del record peer infrastructure. Per una spiegazione completa di XML Schema, vedere Schema degli attributi dei record.

L'infrastruttura peer riserva diversi nomi di attributo che un utente non può impostare. L'elenco seguente identifica i nomi degli attributi riservati:

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
peercreationtime
peerlastmodificationtime

ftCreation

Specifica l'ora UTC (Coordinated Universal Time) creata da un record. L'infrastruttura peer fornisce questo valore e il valore è impostato su zero (0) nelle chiamate a PeerGroupAddRecord. Un'applicazione non può impostare questo membro.

ftExpiration

Ora UTC di scadenza di un record. Questo membro è obbligatorio. Può essere aggiornato a un valore di ora maggiore del valore di ora specificato in origine, ma non può essere minore del valore specificato in origine.

Nota Se dwFlags è impostato su PEER_RECORD_FLAG_AUTOREFRESH, non impostare il valore di ftExpiration su meno di quattro (4) minuti. Se questo membro è impostato su meno di quattro (4) minuti, può verificarsi un comportamento non definito.

ftLastModified

Ora UTC di modifica di un record. L'infrastruttura peer fornisce questo valore. Impostare questo membro su NULL quando si chiama PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord e PeerGroupUpdateRecord. Un'applicazione non può impostare questo membro.

securityData

Specifica i dati di sicurezza contenuti in una struttura di PEER_DATA . L'API Graphing usa questo membro e fornisce al provider di sicurezza una posizione in cui archiviare i dati di sicurezza, ad esempio una firma. L'API di raggruppamento non può modificare questo membro.

data

Specifica i dati effettivi contenuti da questo record.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Intestazione	p2p.h