다음을 통해 공유

PEER_INVITATION_INFO 구조체(p2p.h)

  • 아티클

PEER_INVITATION_INFO 구조는 피어 그룹에 가입하기 위한 초대에 대한 정보를 정의합니다. 초대는 유니코드 문자열로 표시됩니다. 이 구조를 가져오려면 PeerGroupCreateInvitation 에서 만든 XML 초대 문자열을 PeerGroupParseInvitation에 전달합니다.

구문

typedef struct peer_invitation_info_tag {
  DWORD                            dwSize;
  DWORD                            dwFlags;
  PWSTR                            pwzCloudName;
  DWORD                            dwScope;
  DWORD                            dwCloudFlags;
  PWSTR                            pwzGroupPeerName;
  PWSTR                            pwzIssuerPeerName;
  PWSTR                            pwzSubjectPeerName;
  PWSTR                            pwzGroupFriendlyName;
  PWSTR                            pwzIssuerFriendlyName;
  PWSTR                            pwzSubjectFriendlyName;
  FILETIME                         ftValidityStart;
  FILETIME                         ftValidityEnd;
  ULONG                            cRoles;
  PEER_ROLE_ID                     *pRoles;
  ULONG                            cClassifiers;
  PWSTR                            *ppwzClassifiers;
  CERT_PUBLIC_KEY_INFO             *pSubjectPublicKey;
  PEER_GROUP_AUTHENTICATION_SCHEME authScheme;
} PEER_INVITATION_INFO, *PPEER_INVITATION_INFO;

멤버

dwSize

이 구조체의 크기를 바이트 단위로 지정합니다.

dwFlags

0x00000000 설정해야 합니다.

pwzCloudName

PNRP 클라우드 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

dwScope

피어 그룹이 등록된 scope 지정합니다.

값 의미
PNRP_GLOBAL_SCOPE
 인터넷을 포함한 글로벌 scope.
PNRP_LOCAL_SCOPE
 로컬 범위.
PNRP_LINK_LOCAL_SCOPE
 링크-로컬 scope.

dwCloudFlags

PNRP 클라우드 기능을 설명하는 플래그 집합을 지정합니다.

값 의미
PNRP_CLOUD_NO_FLAGS
0
 플래그가 설정되지 않습니다.
PNRP_CLOUD_NAME_LOCAL
1
 클라우드 이름은 다른 컴퓨터에서 사용할 수 없습니다. 로컬로 정의됩니다.

pwzGroupPeerName

피어 그룹의 피어 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

pwzIssuerPeerName

초대를 발급하는 피어의 PNRP 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

pwzSubjectPeerName

초대를 받는 피어의 PNRP 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

pwzGroupFriendlyName

피어 그룹의 친숙한(표시) 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

pwzIssuerFriendlyName

초대를 발급하는 피어의 친숙한(표시) 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

pwzSubjectFriendlyName

초대를 받는 피어의 친숙한(표시) 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

ftValidityStart

초대가 유효해지는 시기를 나타내는 UTC FILETIME 값을 지정합니다.

ftValidityEnd

초대가 유효하지 않은 경우를 나타내는 UTC FILETIME 값을 지정합니다.

cRoles

pRoles에 있는 역할 GUID 수를 지정합니다.

pRoles

사용 가능한 역할의 결합된 집합을 지정하는 GUID 목록에 대한 포인터입니다. 사용 가능한 역할은 다음과 같습니다.

값 의미
PEER_GROUP_ROLE_ADMIN
 이 역할은 초대를 발급하고, 멤버 자격을 갱신하고, 피어 그룹 속성을 수정하고, 레코드를 게시 및 업데이트하고, 다른 관리자의 GMC를 갱신할 수 있습니다.
PEER_GROUP_ROLE_MEMBER
 역할은 피어 그룹 데이터베이스에 레코드를 게시할 수 있습니다.

cClassifiers

ppwzClassifiers에 나열된 문자열 값의 수를 포함하는 부호 없는 정수 값입니다. 이 필드는 나중에 사용되도록 예약되어 있습니다.

ppwzClassifiers

유니코드 문자열에 대한 포인터 목록입니다. 이 필드는 나중에 사용되도록 예약되어 있습니다.

pSubjectPublicKey

받는 사람의 반환된 공개 키와 사용하는 암호화 알고리즘 유형이 포함된 CERT_PUBLIC_KEY_INFO 구조체에 대한 포인터입니다.

authScheme

Windows Vista 이상. 피어 그룹 초대의 유효성을 검사하는 데 사용되는 인증 유형을 나타내는 PEER_GROUP_AUTHENTICATION_SCHEME 열거형 값입니다.

요구 사항

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

추가 정보

PeerGroupParseInvitation