estrutura PEER_SECURITY_INTERFACE (p2p.h)

Artigo
03/15/2023

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