структура PEER_SECURITY_INTERFACE (p2p.h)
Структура PEER_SECURITY_INTERFACE определяет интерфейсы безопасности, которые вызовы API однорангового графирования используют для проверки, защиты и освобождения записей. Кроме того, он позволяет приложению указать путь к .DLL, который содержит реализацию поставщика служб безопасности (SSP).
Синтаксис
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
Указывает полный путь и имя файла .DLL, реализующего интерфейс поставщика общих служб. Дополнительные сведения об интерфейсе поставщика общих служб см. в документации по SSPI .
pwzPackageName
Указывает идентификатор модуля безопасности в поставщике общих служб для использования.
cbSecurityInfo
Указывает число байтов элемента pbSecurityInfo . Этот член не является обязательным, если pbSecurityInfo имеет значение NULL. Однако если pbSecurityInfo не имеет значение NULL, этот элемент должен иметь значение .
pbSecurityInfo
Указатель на буфер, содержащий сведения, используемые для создания или открытия однорангового графа. Этот член является необязательным и может иметь значение NULL.
Большой двоичный объект данных безопасности, на который указывает pbSecurityInfo , копируется, а затем передается в вызов функции SSPI AcquireCredentialsHandle.
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
Комментарии
Если вы разработали собственный поставщик общих служб, приложение не должно вызывать API однорангового графирования для доступа к данным в базе данных графирования. это может привести к взаимоблокировки. Вместо этого приложение должно искать кэшированную копию сведений.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP |
Минимальная версия сервера | Ни одна версия не поддерживается |
Верхняя часть | p2p.h |