estrutura PEER_SECURITY_INTERFACE (p2p.h)
A estrutura PEER_SECURITY_INTERFACE especifica as interfaces de segurança que chamadas para APIs de Grafo de Pares usam para validar, proteger e liberar registros. Além disso, ele permite que um aplicativo especifique o caminho para o .DLL que contém uma implementação de um provedor de serviços de segurança (SSP).
Sintaxe
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;
Membros
dwSize
Especifica o tamanho da estrutura. Defina o valor como sizeof(PEER_SECURITY_INTERFACE). Esse membro é necessário e não tem nenhum valor padrão.
pwzSspFilename
Especifica o caminho completo e o nome do arquivo de um .DLL que implementa a interface SSP. Consulte a documentação do SSPI para obter mais informações sobre a interface SSP.
pwzPackageName
Especifica a ID do módulo de segurança no SSP a ser usado.
cbSecurityInfo
Especifica a contagem de bytes do membro pbSecurityInfo . Esse membro não será necessário se pbSecurityInfo for NULL. No entanto, se pbSecurityInfo não for NULL, esse membro deverá ter um valor.
pbSecurityInfo
Ponteiro para um buffer que contém as informações usadas para criar ou abrir um grafo par. Esse membro é opcional e pode ser NULL.
O blob de dados de segurança apontado por pbSecurityInfo é copiado e, em seguida, passado para a chamada de função SSPI de AcquireCredentialsHandle.
pvContext
Ponteiro para o contexto de segurança. Esse contexto de segurança é então passado como o primeiro parâmetro para PFNPEER_VALIDATE_RECORD, PFNPEER_FREE_SECURITY_DATA e PFNPEER_SECURE_RECORD. Esse membro é opcional e pode ser NULL.
pfnValidateRecord
Ponteiro para uma função de retorno de chamada que é chamada quando um registro requer validação. Esse membro é opcional e pode ser NULL. Se pfnSecureRecord for NULL, esse membro também deverá ser NULL.
pfnSecureRecord
Ponteiro para uma função de retorno de chamada que é chamada quando um registro deve ser protegido. Esse membro é opcional e pode ser NULL. Se pfnValidateRecord for NULL, esse membro também deverá ser NULL.
pfnFreeSecurityData
Ponteiro para uma função de retorno de chamada usada para liberar todos os dados alocados pelo retorno de chamada apontado por pfnSecureRecord. Esse membro é opcional e pode ser NULL.
pfnAuthFailed
Comentários
Se você desenvolveu seu próprio SSP, seu aplicativo não deve chamar a API de Grafo par para acessar dados no banco de dados de grafo; Fazer isso pode levar a uma situação de deadlock. Em vez disso, o aplicativo deve examinar uma cópia armazenada em cache das informações.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP |
| Servidor mínimo com suporte | Nenhum compatível |
| Cabeçalho | p2p.h |