PFNPEER_SECURE_RECORD 콜백 함수(p2p.h)

PFNPEER_SECURE_RECORD 콜백은 피어 그래프 인프라가 레코드를 보호하기 위해 호출하는 함수를 지정합니다.

구문

PFNPEER_SECURE_RECORD PfnpeerSecureRecord;

HRESULT PfnpeerSecureRecord(
  [in]  HGRAPH hGraph,
  [in]  PVOID pvContext,
  [in]  PPEER_RECORD pRecord,
  [in]  PEER_RECORD_CHANGE_TYPE changeType,
  [out] PPEER_DATA *ppSecurityData
)
{...}

매개 변수

[in] hGraph

지정된 레코드와 연결된 피어 그래프를 지정합니다.

[in] pvContext

보안 컨텍스트에 대한 포인터입니다. 이 매개 변수는 PEER_SECURITY_INTERFACE 구조체의 pvContext 멤버를 가리킵니다.

[in] pRecord

보호할 레코드에 대한 포인터입니다.

[in] changeType

유효성 검사가 수행되어야 하는 이유를 지정합니다. PEER_RECORD_CHANGE_TYPE 유효한 값을 열거합니다.

[out] ppSecurityData

이 레코드의 보안 데이터를 지정합니다. 이 데이터는 데이터가 복사되어 레코드에 추가된 후 PEER_SECURITY_INTERFACEpfnFreeSecurityData 멤버에 지정된 메서드를 호출하여 해제됩니다.

반환 값

이 콜백이 성공하면 반환 값이 S_OK.

설명

이 콜백은 애플리케이션이 PeerGraphAddRecord 또는 PeerGraphUpdateRecord 와 같은 레코드를 수정하는 메서드를 호출할 때마다 호출 됩니다. 이 콜백
는 작은 디지털 서명과 같이 이 레코드와 관련된 데이터를 만들고 ppSecurityData 매개 변수를 통해 반환해야 합니다. 그런 다음 이 데이터는 securityData 멤버의 레코드에 추가되고, PEER_SECURITY_INTERFACEpfnValidateRecord 멤버가 지정한 메서드에 의해 확인됩니다.

참고 이 프로세스는 로컬 컴퓨터와 피어가 레코드를 받을 때 그래프에 연결된 모든 피어에서 발생합니다.

 

changeType 매개 변수로 지정된 작업이 허용되지 않는 경우 콜백은 S_OK 대신 실패 코드(예: PEER_E_NOT_AUTHORIZED)를 반환해야 합니다.

이 콜백은 PeerGraphUpdateRecord와 같은 레코드와 관련된 Peer Graphing API 함수에서 호출할 수 있습니다.

요구 사항

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

추가 정보

PEER_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE