Função FwpmConnectionGetSecurityInfo0 (fwpmk.h)

Artigo
07/16/2024

A função FwpmConnectionGetSecurityInfo0 recupera uma cópia do descritor de segurança para um evento de alteração de objeto de conexão.

Sintaxe

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

Parâmetros

[in] engineHandle

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

[in] securityInfo

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

[out] sidOwner

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

[out] sidGroup

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

[out] dacl

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

[out] sacl

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

[out] securityDescriptor

O descritor de segurança retornado.

Valor de retorno

Código/valor de retorno	Descrição
ERROR_SUCCESS 0	O descritor de segurança foi recuperado com êxito.
*FWP_E_ código de erro** 0x80320001 — 0x80320039	Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte de 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 local ou remoto.
outros códigos NTSTATUS	Ocorreu um erro.

Observações

O parâmetro securityDescriptor de retornado deve ser liberado por meio de uma chamada para FwpmFreeMemory0FwpmFreeMemory0. Os outros quatro parâmetros retornados 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 descritos no tópico de referência GetSecurityInfo .

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	fwpmk.h
biblioteca	fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

Compartilhar via