PEER_SECURITY_INTERFACE 구조체(p2p.h)
PEER_SECURITY_INTERFACE 구조는 Peer Graphing API를 호출하여 레코드의 유효성을 검사하고, 보호하고, 해제하는 데 사용하는 보안 인터페이스를 지정합니다. 또한 애플리케이션에서 SSP(보안 서비스 공급자)의 구현을 포함하는 .DLL 경로를 지정할 수 있습니다.
구문
typedef struct peer_security_interface_tag {
DWORD dwSize;
PWSTR pwzSspFilename;
PWSTR pwzPackageName;
ULONG cbSecurityInfo;
PBYTE pbSecurityInfo;
PVOID pvContext;
PFNPEER_VALIDATE_RECORD pfnValidateRecord;
PFNPEER_SECURE_RECORD pfnSecureRecord;
PFNPEER_FREE_SECURITY_DATA pfnFreeSecurityData;
PFNPEER_ON_PASSWORD_AUTH_FAILED pfnAuthFailed;
} PEER_SECURITY_INTERFACE, *PPEER_SECURITY_INTERFACE;
멤버
dwSize
구조체의 크기를 지정합니다. 값을 sizeof(PEER_SECURITY_INTERFACE)로 설정합니다. 이 멤버는 필수이며 기본값이 없습니다.
pwzSspFilename
SSP 인터페이스를 구현하는 .DLL 전체 경로 및 파일 이름을 지정합니다. SSP 인터페이스에 대한 자세한 내용은 SSPI 설명서를 참조하세요.
pwzPackageName
사용할 SSP의 보안 모듈 ID를 지정합니다.
cbSecurityInfo
pbSecurityInfo 멤버의 바이트 수를 지정합니다. pbSecurityInfo가 NULL인 경우에는 이 멤버가 필요하지 않습니다. 그러나 pbSecurityInfo 가 NULL이 아니면 이 멤버에 값이 있어야 합니다.
pbSecurityInfo
피어 그래프를 만들거나 여는 데 사용되는 정보가 포함된 버퍼에 대한 포인터입니다. 이 멤버는 선택 사항이며 NULL일 수 있습니다.
pbSecurityInfo가 가리키는 보안 데이터 Blob이 복사된 다음 AcquireCredentialsHandle의 SSPI 함수 호출에 전달됩니다.
pvContext
보안 컨텍스트에 대한 포인터입니다. 그런 다음 이 보안 컨텍스트가 PFNPEER_VALIDATE_RECORD, PFNPEER_FREE_SECURITY_DATA및PFNPEER_SECURE_RECORD 첫 번째 매개 변수로 전달됩니다. 이 멤버는 선택 사항이며 NULL일 수 있습니다.
pfnValidateRecord
레코드에 유효성 검사가 필요할 때 호출되는 콜백 함수에 대한 포인터입니다. 이 멤버는 선택 사항이며 NULL일 수 있습니다. pfnSecureRecord가 NULL인 경우 이 멤버도 NULL이어야 합니다.
pfnSecureRecord
레코드를 보호해야 할 때 호출되는 콜백 함수에 대한 포인터입니다. 이 멤버는 선택 사항이며 NULL일 수 있습니다. pfnValidateRecord가 NULL이면 이 멤버도 NULL이어야 합니다.
pfnFreeSecurityData
pfnSecureRecord가 가리키는 콜백에 의해 할당된 모든 데이터를 해제하는 데 사용되는 콜백 함수에 대한 포인터입니다. 이 멤버는 선택 사항이며 NULL일 수 있습니다.
pfnAuthFailed
설명
사용자 고유의 SSP를 개발한 경우 애플리케이션이 피어 Graphing API를 호출하여 그래프 데이터베이스의 데이터에 액세스해서는 안 됩니다. 이렇게 하면 교착 상태가 발생할 수 있습니다. 대신 애플리케이션은 캐시된 정보 복사본을 확인해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP SP1 및 고급 네트워킹 팩 forWindows XP |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 머리글 | p2p.h |