estructura PEER_RECORD (p2p.h)
La estructura PEER_RECORD contiene el objeto de registro que usa una aplicación.
Sintaxis
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;
Miembros
dwSize
Especifica el tamaño de una estructura. Establezca el valor en sizeof(PEER_RECORD).
type
Especifica el tipo de registro. El tipo es un GUID que debe especificar una aplicación. El GUID representa un tipo de registro único, por ejemplo, un registro de chat.
id
Especifica el identificador único de un registro. La infraestructura del mismo nivel proporciona este identificador. Este parámetro se omite en las llamadas a PeerGroupAddRecord. Una aplicación no puede modificar este miembro.
dwVersion
Especifica la versión de un registro que proporciona la infraestructura del mismo nivel cuando una aplicación llama a PeerGraphAddRecord o PeerGraphUpdateRecord. Una aplicación no puede modificar este miembro.
dwFlags
Especifica las marcas que indican el procesamiento especial, que se debe aplicar a un registro. En la tabla siguiente se identifican los valores válidos.
| Valor | Descripción |
|---|---|
| PEER_RECORD_FLAG_AUTOREFRESH | Indica que un registro se actualiza automáticamente cuando está listo para expirar. |
| PEER_RECORD_FLAG_DELETED | Indica que un registro se marca como eliminado. |
pwzCreatorId
Puntero al identificador único de un creador de registros. Este miembro se establece en NULL para las llamadas a PeerGraphAddRecord y PeerGraphUpdateRecord. Una aplicación no puede establecer este miembro.
pwzModifiedById
Especifica el identificador único de la última persona que cambia un registro. Una aplicación no puede establecer este miembro.
pwzAttributes
Puntero al conjunto de pares de nombre y valor de atributo asociados a un registro. Este miembro apunta a una cadena XML. Los atributos de registro se especifican como una cadena XML y deben ser coherentes con el esquema de atributo de registro de infraestructura del mismo nivel. Para obtener una explicación completa del esquema XML, vea Esquema de atributo de registro.
La infraestructura del mismo nivel reserva varios nombres de atributo que un usuario no puede establecer. En la lista siguiente se identifican los nombres de atributo reservados:
- peerlastmodifiedby
- peercreatorid
- peerlastmodificationtime
- peerrecordid
- peerrecordtype
- peercreationtime
- peerlastmodificationtime
ftCreation
Especifica la hora universal coordinada (UTC) que se crea un registro. La infraestructura del mismo nivel proporciona este valor y el valor se establece en cero (0) en llamadas a PeerGroupAddRecord. Una aplicación no puede establecer este miembro.
ftExpiration
Hora UTC a la que expira un registro. Este miembro es obligatorio. Se puede actualizar a un valor de hora mayor que el valor de hora especificado originalmente, pero no puede ser menor que el valor especificado originalmente.
ftLastModified
Hora UTC a la que se modifica un registro. La infraestructura del mismo nivel proporciona este valor. Establezca este miembro en NULL al llamar a PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord y PeerGroupUpdateRecord. Una aplicación no puede establecer este miembro.
securityData
Especifica los datos de seguridad contenidos en una estructura de PEER_DATA . Graphing API usa este miembro y proporciona al proveedor de seguridad un lugar para almacenar datos de seguridad, por ejemplo, una firma. La API de agrupación no puede modificar este miembro.
data
Especifica los datos reales que contiene este registro.
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 |