Compartilhar via

Função FwpmLayerSetSecurityInfoByKey0 (fwpmk.h)

  • Artigo

A função FwpmLayerSetSecurityInfoByKey0 define informações de segurança especificadas no descritor de segurança de um objeto de camada.

Sintaxe

NTSTATUS FwpmLayerSetSecurityInfoByKey0(
  [in] HANDLE               engineHandle,
       const GUID           *key,
       SECURITY_INFORMATION securityInfo,
       const SID            *sidOwner,
       const SID            *sidGroup,
       const ACL            *dacl,
       const ACL            *sacl
);

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.

key

Identificador exclusivo da camada. Consulte Filtragem de Identificadores de Camada para obter uma lista de possíveis valores guid.

securityInfo

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

sidOwner

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

sidGroup

O SID do grupo a ser definido no descritor de segurança.

dacl

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

sacl

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

Valor de retorno

Código/valor de retorno Descrição
ERROR_SUCCESS
0		 O descritor de segurança foi definido 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

Se o parâmetro chave for NULL ou se for um GUID de NULL , essa função gerenciará as informações de segurança do contêiner de camadas.

Essa função não pode ser chamada de dentro de uma transação, ela falha com FWP_E_TXN_IN_PROGRESS. Consulte de Gerenciamento de Objetos para obter mais informações sobre transações.

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

FwpmLayerSetSecurityInfoByKey0 é uma implementação específica de FwpmLayerSetSecurityInfoByKey. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

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

Consulte também