Função IPsecSaDbGetSecurityInfo0 (fwpmu.h)

  • Artigo

A função IPsecSaDbGetSecurityInfo0 recupera uma cópia do descritor de segurança para o banco de dados SA (associação de segurança) IPsec.

Sintaxe

DWORD IPsecSaDbGetSecurityInfo0(
  [in]            HANDLE               engineHandle,
  [in]            SECURITY_INFORMATION securityInfo,
  [out, optional] PSID                 *sidOwner,
  [out, optional] PSID                 *sidGroup,
  [out, optional] PACL                 *dacl,
  [out, optional] PACL                 *sacl,
  [out]           PSECURITY_DESCRIPTOR *securityDescriptor
);

Parâmetros

[in] engineHandle

Tipo: HANDLE

Identificador de uma sessão aberta para o mecanismo de filtro. Chame FwpmEngineOpen0 para abrir uma sessão para o mecanismo de filtro.

[in] securityInfo

Tipo: SECURITY_INFORMATION

O tipo de informações de segurança a serem recuperadas.

[out, optional] sidOwner

Tipo: PSID*

O SID (identificador de segurança) do proprietário no descritor de segurança retornado.

[out, optional] sidGroup

Tipo: PSID*

O SID (identificador de segurança do grupo primário) no descritor de segurança retornado.

[out, optional] dacl

Tipo: PACL*

A DACL (lista de controle de acesso discricionário) no descritor de segurança retornado.

[out, optional] sacl

Tipo: PACL*

A SACL (lista de controle de acesso do sistema) no descritor de segurança retornado.

[out] securityDescriptor

Tipo: PSECURITY_DESCRIPTOR*

O descritor de segurança retornado.

Retornar valor

Tipo: DWORD

Valor/código retornado Descrição
ERROR_SUCCESS
0
 O descritor de segurança foi recuperado com êxito.
código de erro FWP_E_*
0x80320001 — 0x80320039
 Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro do WFP para obter detalhes.
código de erro RPC_*
0x80010001 — 0x80010122
 Falha ao se comunicar com o mecanismo de firewall remoto ou local.

Comentários

O parâmetro securityDescriptor retornado deve ser liberado por meio de uma chamada para FwpmFreeMemory0. Os outros quatro parâmetros retornados (opcionais) não devem ser liberados, pois apontam para endereços dentro do parâmetro securityDescriptor .

Essa função se comporta como a função GetSecurityInfo padrão do Win32. O chamador precisa dos mesmos direitos de acesso padrão, conforme descrito no tópico de referência GetSecurityInfo .

IPsecSaDbGetSecurityInfo0 é uma implementação específica de IPsecSaDbGetSecurityInfo. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho fwpmu.h
Biblioteca Fwpuclnt.lib
DLL Fwpuclnt.dll

Confira também

IPsecSaDbSetSecurityInfo