struktur PEER_SECURITY_INTERFACE (p2p.h)

Struktur PEER_SECURITY_INTERFACE menentukan antarmuka keamanan yang memanggil PEER Graphing API yang digunakan untuk memvalidasi, mengamankan, dan membebaskan rekaman. Selain itu, ini memungkinkan aplikasi untuk menentukan jalur ke .DLL yang berisi implementasi penyedia layanan keamanan (SSP).

Sintaks

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;

Anggota

dwSize

Menentukan ukuran struktur. Atur nilai ke sizeof(PEER_SECURITY_INTERFACE). Anggota ini diperlukan dan tidak memiliki nilai default.

pwzSspFilename

Menentukan jalur lengkap dan nama file .DLL yang mengimplementasikan antarmuka SSP. Lihat dokumentasi SSPI untuk informasi lebih lanjut tentang antarmuka SSP.

pwzPackageName

Menentukan ID modul keamanan dalam SSP yang akan digunakan.

cbSecurityInfo

Menentukan jumlah byte anggota pbSecurityInfo . Anggota ini tidak diperlukan jika pbSecurityInfoADALAH NULL. Namun, jika pbSecurityInfo bukan NULL, anggota ini harus memiliki nilai.

pbSecurityInfo

Penunjuk ke buffer yang berisi informasi yang digunakan untuk membuat atau membuka grafik serekan. Anggota ini bersifat opsional dan dapat berupa NULL.

Blob data keamanan yang ditunjukkan oleh pbSecurityInfo disalin dan kemudian diteruskan ke panggilan fungsi SSPI acquireCredentialsHandle.

pvContext

Arahkan ke konteks keamanan. Konteks keamanan ini kemudian diteruskan sebagai parameter pertama untuk PFNPEER_VALIDATE_RECORD, PFNPEER_FREE_SECURITY_DATA, dan PFNPEER_SECURE_RECORD. Anggota ini bersifat opsional dan dapat berupa NULL.

pfnValidateRecord

Penunjuk ke fungsi panggilan balik yang dipanggil saat rekaman memerlukan validasi. Anggota ini bersifat opsional dan dapat berupa NULL. Jika pfnSecureRecord adalah NULL, anggota ini juga harus NULL.

pfnSecureRecord

Penunjuk ke fungsi panggilan balik yang dipanggil ketika rekaman harus diamankan. Anggota ini bersifat opsional dan dapat berupa NULL. Jika pfnValidateRecordADALAH NULL, anggota ini juga harus NULL.

pfnFreeSecurityData

Penunjuk ke fungsi panggilan balik yang digunakan untuk membebaskan data apa pun yang dialokasikan oleh panggilan balik yang ditunjukkan oleh pfnSecureRecord. Anggota ini bersifat opsional dan dapat berupa NULL.

pfnAuthFailed

Keterangan

Jika Anda telah mengembangkan SSP Anda sendiri, aplikasi Anda tidak boleh memanggil PEER Graphing API untuk mengakses data dalam database grafik; hal itu dapat menyebabkan situasi kebuntuan. Sebaliknya, aplikasi harus melihat salinan informasi yang di-cache.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Advanced Networking Pack forWindows XP
Server minimum yang didukung	Tidak ada yang didukung
Header	p2p.h

Lihat juga

AcquireCredentialsHandle

PFNPEER_FREE_SECURITY_DATA

PFNPEER_SECURE_RECORD

PFNPEER_VALIDATE_RECORD

PeerGraphBuat

PeerGraphBuka