Compartilhar via

Função FwpmSubLayerSetSecurityInfoByKey0 (fwpmk.h)

  • Artigo

A função FwpmSubLayerSetSecurityInfoByKey0 define informações de segurança especificadas no descritor de segurança de uma subcamada.

Sintaxe

NTSTATUS FwpmSubLayerSetSecurityInfoByKey0(
  [in]           HANDLE               engineHandle,
  [in, optional] const GUID           *key,
  [in]           SECURITY_INFORMATION securityInfo,
  [in, optional] const SID            *sidOwner,
  [in, optional] const SID            *sidGroup,
  [in, optional] const ACL            *dacl,
  [in, optional] 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.

[in, optional] key

Identificador exclusivo do subcaminho. Esse deve ser o mesmo GUID especificado quando o aplicativo chamado FwpmSubLayerAdd0.

[in] securityInfo

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

[in, optional] sidOwner

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

[in, optional] sidGroup

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

[in, optional] dacl

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

[in, optional] 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 subcaminhos.

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

Essa função poderá ser chamada em uma sessão dinâmica se o objeto correspondente tiver sido adicionado durante a mesma sessão. Se essa função for chamada para um objeto que foi adicionado durante uma sessão dinâmica diferente, ela falhará com FWP_E_WRONG_SESSION. Se essa função for chamada para um objeto que não foi adicionado durante uma sessão dinâmica, ela falhará com FWP_E_DYNAMIC_SESSION_IN_PROGRESS.

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

FwpmSubLayerSetSecurityInfoByKey0 é uma implementação específica de FwpmSubLayerSetSecurityInfoByKey. 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