다음을 통해 공유

PeerGroupIssueCredentials 함수(p2p.h)

  • 아티클

PeerGroupIssueCredentials 함수는 GMC를 포함한 자격 증명을 특정 ID에 발급하고, 필요에 따라 초대된 피어가 피어 그룹에 조인하는 데 사용할 수 있는 초대 XML 문자열을 반환합니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupIssueCredentials(
  [in]  HGROUP               hGroup,
  [in]  PCWSTR               pwzSubjectIdentity,
  [in]  PEER_CREDENTIAL_INFO *pCredentialInfo,
  [in]  DWORD                dwFlags,
  [out] PWSTR                *ppwzInvitation
);

매개 변수

[in] hGroup

피어가 잠재적 초대된 피어에 자격 증명을 발급할 피어 그룹에 대한 핸들입니다. 이 핸들은 PeerGroupCreate, PeerGroupOpen 또는 PeerGroupJoin 함수에서 반환됩니다. 이 매개 변수는 필수입니다.

[in] pwzSubjectIdentity

자격 증명이 발급될 피어의 ID를 지정합니다. 이 매개 변수는 필수입니다.

[in] pCredentialInfo

pwzSubjectIdentity에서 ID가 지정된 피어의 자격 증명에 대한 정보를 포함하는 PEER_CREDENTIAL_INFO 구조체입니다. 이 매개 변수가 NULL이면 피어 데이터베이스에 저장된 정보가 대신 사용됩니다. 이 매개 변수는 선택적 요소입니다.

이 매개 변수가 제공되면 PEER_CREDENTIAL_INFO 다음 필드가 무시됩니다.

  • pwzIssuerPeerName
  • pwzIssuerFriendlyName

[in] dwFlags

자격 증명을 발급할 때 수행되는 작업을 설명하는 데 사용되는 플래그 집합을 지정합니다. 이 매개 변수를 0으로 설정하면 자격 증명이 ppwzInvitation으로 반환됩니다. 이 매개 변수는 선택 사항입니다.

값 의미
PEER_GROUP_STORE_CREDENTIALS
 그룹 데이터베이스에 주체 ID의 새로 만든 GMC를 게시합니다. GMC는 주체에 의해 자동으로 선택됩니다. 이 플래그가 설정되지 않은 경우 이메일과 같은 다른 애플리케이션에서 자격 증명을 가져와야 합니다.

[out] ppwzInvitation

함수 호출에서 반환된 초대 XML 문자열에 대한 포인터입니다. 이 초대는 PeerGroupJoin에 대한 호출에서 사용하는 초대된 피어에게 대역 외로 전달됩니다. 이 매개 변수는 선택적 요소입니다.

반환 값

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

반환 코드 설명
E_INVALIDARG
 매개 변수 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
 작업을 완료하는 데 사용할 수 있는 메모리가 부족합니다.
PEER_E_IDENTITY_DELETED
 자격 증명을 만드는 ID가 삭제되었습니다.
PEER_E_IDENTITY_NOT_FOUND
 그룹 데이터베이스에서 ID를 찾을 수 없으며 pCredentialInfo 는 NULL입니다.
PEER_E_NO_KEY_ACCESS
 ID 또는 그룹 키에 대한 액세스가 거부됩니다. 일반적으로 이는 사용자 또는 컴퓨터 키가 포함된 폴더에 대한 잘못된 ACL(액세스 제어 목록)으로 인해 발생합니다. 이 문제는 ACL이 수동으로 다시 설정되었을 때 발생할 수 있습니다.
 

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

설명

이 함수는 관리자만 성공적으로 호출할 수 있습니다.

멤버(PEER_CREDENTIAL_INFO)에 대한 자격 증명은 PeerGroupEnumMembers를 호출하여 가져옵니다. 자격 증명은 특정 멤버에 대한 PEER_MEMBER 구조체의 pCredentialInfo 필드에 있습니다.

요구 사항

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