PEER_GRAPH_PROPERTIES 구조체(p2p.h)

PEER_GRAPH_PROPERTIES 구조에는 피어 그래프, ID, scope 및 기타 정보의 정책에 대한 데이터가 포함됩니다.

구문

typedef struct peer_graph_properties_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwScope;
  DWORD dwMaxRecordSize;
  PWSTR pwzGraphId;
  PWSTR pwzCreatorId;
  PWSTR pwzFriendlyName;
  PWSTR pwzComment;
  ULONG ulPresenceLifetime;
  ULONG cPresenceMax;
} PEER_GRAPH_PROPERTIES, *PPEER_GRAPH_PROPERTIES;

멤버

dwSize

이 데이터 구조의 크기(바이트)를 지정합니다. peerGraphCreate를 호출하기 전에 dwSize 멤버를 PEER_GRAPH_PROPERTIES 크기로 설정해야 합니다. 이 멤버는 필수입니다. 기본값이 없습니다.

dwFlags

그래프에서 피어의 동작을 제어하는 플래그입니다. 기본값은 플래그가 설정되어 있지 않습니다. 유효한 값은 다음 표에서 식별됩니다.

값	Description
PEER_GRAPH_PROPERTY_DEFER_EXPIRATION	그래프 레코드를 만료할 시기를 지정합니다. 그래프가 연결되지 않고 이 플래그가 설정되면 그래프가 하나 이상의 다른 멤버에 연결될 때까지 만료가 발생하지 않습니다.

dwScope

피어 그래프 ID가 게시되는 scope 지정합니다. 기본값은 전역입니다. 유효한 값은 다음 표에서 식별됩니다.

값	Description
PEER_GRAPH_SCOPE_GLOBAL	범위에는 인터넷이 포함됩니다.
PEER_GRAPH_SCOPE_LINK_LOCAL	범위는 로컬 서브넷으로 제한됩니다.
PEER_GRAPH_SCOPE_SITE_LOCAL	범위는 사이트(예: 회사 인트라넷)로 제한됩니다.

dwMaxRecordSize

피어 그래프에 추가할 수 있는 가장 큰 레코드를 나타내는 값을 지정합니다. 유효한 값은 기본 최대 레코드 크기(60MB)와 1024바이트에서 60MB 사이의 모든 값을 나타내는 0입니다.

pwzGraphId

피어 그래프의 고유 식별자를 지정합니다. 이 ID는 컴퓨터/사용자 쌍에 대해 고유해야 합니다. 이 멤버는 필수이며 기본값이 없습니다. 문자열 값이 256자보다 크면(null 종결자 포함) 오류가 반환됩니다.

pwzCreatorId

피어 그래프 작성자의 고유 식별자를 지정합니다. 이 멤버는 필수이며 기본값이 없습니다. 문자열 값이 256자보다 크면(null 종결자 포함) 오류가 반환됩니다.

pwzFriendlyName

피어 그래프의 이름을 지정합니다. 이 멤버는 선택 사항이며 NULL일 수 있습니다. 기본값은 NULL입니다. 이 문자열의 최대 길이는 null 종결자를 포함하여 256자입니다.

pwzComment

피어 그래프를 설명하는 데 사용되는 주석을 지정합니다. 이 멤버는 선택 사항이며 NULL일 수 있습니다. 기본값은 NULL입니다. 이 문자열의 최대 길이는 null 종결자를 포함하여 512자입니다.

ulPresenceLifetime

현재 상태 레코드가 만료되기 전의 시간(초)을 지정합니다. 기본값은 300초(5분)입니다. ulPresenceLifetime 값을 300초 미만으로 설정하지 마세요. 이 멤버가 300(5분) 기본값보다 작게 설정된 경우 정의되지 않은 동작이 발생할 수 있습니다.

cPresenceMax

피어 인프라가 피어 그래프에 한 번에 유지하는 현재 상태 레코드 수를 지정합니다. 현재 상태가 게시된 노드는 PeerGraphEnumNodes를 사용하여 다른 모든 노드에서 열거할 수 있습니다. 다음 표에서 식별된 값 중 하나를 지정하여 사용자에 대한 현재 상태 레코드를 게시하는 방법을 지정합니다.

값	Description
-1	현재 상태 레코드는 모든 사용자에 대해 자동으로 게시됩니다.
0	현재 상태 레코드는 자동으로 게시되지 않습니다.
1-N	한 번에 최대 N개의 현재 상태 레코드가 게시됩니다. 게시된 현재 상태 레코드는 피어 그래프 인프라에서 임의로 선택됩니다.

설명

애플리케이션은 PeerGraphSetPresence를 사용하여 피어 그래프 인프라가 현재 상태 정보를 게시하도록 강제할 수 있습니다.

PeerGraphSetProperties를 호출할 때 PEER_GRAPH_PROPERTIES 특정 필드만 업데이트할 수 있습니다. 다음 멤버를 업데이트할 수 있습니다.

• pwzFriendlyName
• pwzComment
• ulPresenceLifetime
• cPresenceMax

나머지 멤버는 수정할 수 없습니다.

요구 사항

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

추가 정보

PeerGraph만들기

PeerGraphGetProperties

PeerGraphSetProperties