다음을 통해 공유


PeerGroupCreate 함수(p2p.h)

PeerGroupCreate 함수는 새 피어 그룹을 만듭니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

매개 변수

[in] pProperties

피어 그룹 이름, 초대 수명 및 현재 상태 수명과 같은 그룹의 특정 세부 정보를 지정하는 PEER_GROUP_PROPERTIES 구조체에 대한 포인터입니다. 이 매개 변수는 필수입니다.

다음 멤버를 설정해야 합니다.

  • pwzCreatorPeerName

다음 멤버를 설정할 수 없습니다.

  • pwzGroupPeerName
나머지 멤버는 선택 사항입니다.

[out] phGroup

피어 그룹에 대한 핸들 포인터를 반환합니다. 이 핸들을 매개 변수로 사용하여 호출된 모든 함수에는 해당 피어 그룹에서 수행되는 해당 작업이 있습니다. 이 매개 변수는 필수입니다.

반환 값

작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.

반환 코드 설명
E_INVALIDARG
매개 변수 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
지정된 작업을 수행하기에 충분한 메모리가 없습니다.
PEER_E_CLOUD_NAME_AMBIGUOUS
pProperties에 지정된 클라우드는 고유하게 검색할 수 없습니다(둘 이상의 클라우드가 제공된 이름과 일치).
PEER_E_INVALID_CLASSIFIER
pProperties에 지정된 피어 그룹 분류자는 잘못되었습니다.
PEER_E_INVALID_PEER_NAME
pProperties의 그룹에 지정된 피어 이름이 잘못되었습니다.
PEER_E_INVALID_PROPERTIES
pProperties에 제공된 하나 이상의 피어 그룹 속성이 잘못되었습니다.
PEER_E_NO_CLOUD
pProperties에 지정된 클라우드를 배치할 수 없습니다.
PEER_E_NO_KEY_ACCESS
ID 또는 그룹 키에 대한 액세스가 거부됩니다. 일반적으로 이는 사용자 또는 컴퓨터 키가 포함된 폴더에 대한 잘못된 ACL(액세스 제어 목록)으로 인해 발생합니다. 이 문제는 ACL이 수동으로 다시 설정되면 발생할 수 있습니다.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY
지정된 암호가 시스템 암호 요구 사항을 충족하지 않습니다.
ERROR_DELETE_PENDING
그룹 작성자로 지정된 피어 ID가 삭제되었거나 삭제 중입니다.
 

암호화 관련 오류는 Microsoft RSA 기본 공급자에서 반환할 수 있습니다. 이러한 오류는 CRYPT_*로 접두사로 지정되고 Winerror.h에 정의됩니다.

설명

PeerGroupConnect 는 만든 직후 그룹 작성자가 호출해야 합니다. 이 작업을 수행하지 않으면 초대를 받은 사용자는 PeerGroupConnect를 성공적으로 호출하지만 수신 대기할 수 없으며 결국 연결 실패 이벤트를 받게 됩니다.

애플리케이션은 PeerIdentityCreate 또는 ID 이름 문자열을 반환하는 다른 메서드를 호출하여 ID를 가져옵니다. 이 ID는 그룹의 소유자 역할을 하며 생성 시 피어 그룹의 초기 멤버입니다.

암호를 활용하는 애플리케이션의 경우 CryptoProtectMemorySecureZeroMemory 함수를 호출하여 암호를 안전하게 처리하는 것이 좋습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP SP1 및 고급 네트워킹 팩 forWindows XP
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 p2p.h
라이브러리 P2P.lib
DLL P2P.dll

추가 정보

PEER_GROUP_PROPERTIES

PeerGroupClose

PeerGroupConnect

PeerGroupOpen