PeerGraphCreate 함수(p2p.h)

아티클
03/05/2024

PeerGraphCreate 함수는 새 피어 그래프를 만듭니다. 애플리케이션은 피어 그래프에 대한 정보와 피어 그래프에서 사용하는 보안 유형을 지정할 수 있습니다. 피어 그래프에 대한 핸들이 반환되지만 네트워크 연결이 설정되지 않았습니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphCreate(
  [in]  PPEER_GRAPH_PROPERTIES   pGraphProperties,
  [in]  PCWSTR                   pwzDatabaseName,
  [in]  PPEER_SECURITY_INTERFACE pSecurityInterface,
  [out] HGRAPH                   *phGraph
);

매개 변수

[in] pGraphProperties

PEER_GRAPH_PROPERTIES 구조체에 있는 피어 그래프의 모든 속성입니다.

[in] pwzDatabaseName

만들 때 피어 그래프와 연결할 레코드 데이터베이스의 이름입니다. 레코드 데이터베이스 이름은 유효한 파일 이름이어야 합니다. 파일 이름을 가진 경로는 포함하지 마세요. 파일 이름과 관련된 규칙의 전체 목록은 그래프 Reference_Links 목록에서 파일 항목 이름을 지정 을 참조하세요.

[in] pSecurityInterface

PEER_SECURITY_INTERFACE 구조의 피어 그래프에 대한 보안 공급자에 대한 정보입니다.

[out] phGraph

생성된 피어 그래프에 대한 핸들을 받습니다. 이 핸들이 더 이상 필요하지 않은 경우 PeerGraphClose를 호출하여 해제합니다.

반환 값

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

반환 코드	설명
E_INVALIDARG	매개 변수 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	지정된 작업을 수행하기에 충분한 메모리가 없습니다.
PEER_E_DUPLICATE_GRAPH	지정된 피어 그래프 ID가 이미 있는 데이터베이스입니다.
PEER_E_NOT_INITIALIZED	이 함수를 사용하기 전에 PeerGraphStartup 을 호출하여 피어 그래프를 초기화해야 합니다.

설명

사용자 고유의 SSP(Security Service Provider)를 개발하는 경우 교착 상태가 발생할 수 있으므로 애플리케이션이 피어 그래프 API를 호출하여 피어 그래프 데이터베이스의 데이터에 액세스하지 않아야 합니다. 대신 애플리케이션은 캐시된 정보 복사본을 사용해야 합니다. 캐시된 복사본은 피어 Graphing API에 의해 만들어지지 않습니다. 애플리케이션은 이 데이터를 캐싱하기 위한 메커니즘을 제공해야 합니다.

PeerGraphCreate가 호출된 후 애플리케이션은 PeerGraphListen을 호출하기 전에 이벤트를 구독할 수 있습니다.

요구 사항

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