PEER_RECORD 구조체(p2p.h)

아티클
03/15/2023

PEER_RECORD 구조체에는 애플리케이션에서 사용하는 레코드 개체가 포함됩니다.

구문

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;

멤버

dwSize

구조체의 크기를 지정합니다. 값을 sizeof(PEER_RECORD)로 설정합니다.

type

레코드의 형식을 지정합니다. 형식은 애플리케이션에서 지정해야 하는 GUID 입니다. GUID는 고유한 레코드 유형(예: 채팅 레코드)을 나타냅니다.

id

레코드의 고유 ID를 지정합니다. 피어 인프라는 이 ID를 제공합니다. 이 매개 변수는 PeerGroupAddRecord 호출에서 무시됩니다. 애플리케이션에서 이 멤버를 수정할 수 없습니다.

dwVersion

애플리케이션이 PeerGraphAddRecord 또는 PeerGraphUpdateRecord 를 호출할 때 피어 인프라에서 제공하는 레코드의 버전을 지정 합니다. 애플리케이션에서 이 멤버를 수정할 수 없습니다.

dwFlags

레코드에 적용해야 하는 특수 처리를 나타내는 플래그를 지정합니다. 다음 표에서는 유효한 값을 식별합니다.

값	Description
PEER_RECORD_FLAG_AUTOREFRESH	레코드가 만료될 준비가 되면 자동으로 새로 고쳐지도록 나타냅니다.
PEER_RECORD_FLAG_DELETED	레코드가 삭제된 것으로 표시됨을 나타냅니다.

참고 애플리케이션에서 이러한 플래그를 설정할 수 없습니다.

pwzCreatorId

레코드 작성자의 고유 ID에 대한 포인터입니다. 이 멤버는 PeerGraphAddRecord 및 PeerGraphUpdateRecord에 대한 호출에 대해 NULL로 설정됩니다. 애플리케이션에서 이 멤버를 설정할 수 없습니다.

pwzModifiedById

레코드를 변경한 마지막 사용자의 고유 ID를 지정합니다. 애플리케이션에서 이 멤버를 설정할 수 없습니다.

pwzAttributes

레코드와 연결된 특성 이름 및 값 쌍 집합에 대한 포인터입니다. 이 멤버는 XML 문자열을 가리킵니다. 레코드 특성은 XML 문자열로 지정되며 피어 인프라 레코드 특성 스키마와 일치해야 합니다. XML 스키마에 대한 전체 설명은 레코드 특성 스키마를 참조하세요.

피어 인프라는 사용자가 설정할 수 없는 여러 특성 이름을 예약합니다. 다음 목록에서는 예약된 특성 이름을 식별합니다.

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
peercreationtime
peerlastmodificationtime

ftCreation

레코드가 만들어지는 UTC(협정 세계시)를 지정합니다. 피어 인프라는 이 값을 제공하며 PeerGroupAddRecord에 대한 호출에서 값이 0으로 설정됩니다. 애플리케이션에서 이 멤버를 설정할 수 없습니다.

ftExpiration

레코드가 만료되는 UTC 시간입니다. 이 멤버는 필수입니다. 원래 지정된 시간 값보다 큰 시간 값으로 업데이트할 수 있지만 원래 지정된 값보다 작을 수는 없습니다.

참고dwFlags 가 PEER_RECORD_FLAG_AUTOREFRESH 설정된 경우 ftExpiration 값을 4분 미만으로 설정하지 마세요. 이 멤버가 4분 미만으로 설정된 경우 정의되지 않은 동작이 발생할 수 있습니다.

ftLastModified

레코드가 수정된 UTC 시간입니다. 피어 인프라는 이 값을 제공합니다. PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord 및 PeerGroupUpdateRecord를 호출할 때 이 멤버를 NULL로 설정합니다. 애플리케이션에서 이 멤버를 설정할 수 없습니다.

securityData

PEER_DATA 구조에 포함된 보안 데이터를 지정합니다. Graphing API는 이 멤버를 사용하고 보안 공급자에게 보안 데이터를 저장할 위치(예: 서명)를 제공합니다. 그룹화 API는 이 멤버를 수정할 수 없습니다.

data

이 레코드에 포함된 실제 데이터를 지정합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP SP1 및 고급 네트워킹 팩 forWindows XP
지원되는 최소 서버	지원되는 버전 없음
머리글	p2p.h