PEER_RECORD 구조체(p2p.h)
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 시간입니다. 이 멤버는 필수입니다. 원래 지정된 시간 값보다 큰 시간 값으로 업데이트할 수 있지만 원래 지정된 값보다 작을 수는 없습니다.
ftLastModified
레코드가 수정된 UTC 시간입니다. 피어 인프라는 이 값을 제공합니다. PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord 및 PeerGroupUpdateRecord를 호출할 때 이 멤버를 NULL로 설정합니다. 애플리케이션에서 이 멤버를 설정할 수 없습니다.
securityData
PEER_DATA 구조에 포함된 보안 데이터를 지정합니다. Graphing API는 이 멤버를 사용하고 보안 공급자에게 보안 데이터를 저장할 위치(예: 서명)를 제공합니다. 그룹화 API는 이 멤버를 수정할 수 없습니다.
data
이 레코드에 포함된 실제 데이터를 지정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP SP1 및 고급 네트워킹 팩 forWindows XP |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 머리글 | p2p.h |