Função FwpmProviderContextGetSecurityInfoByKey0 (fwpmu.h)
A função FwpmProviderContextGetSecurityInfoByKey0 recupera uma cópia do descritor de segurança para um objeto de contexto do provedor.
Sintaxe
DWORD FwpmProviderContextGetSecurityInfoByKey0(
[in] HANDLE engineHandle,
[in, optional] const GUID *key,
[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, optional] key
Tipo: const GUID*
Identificador exclusivo do contexto do provedor. Esse é um ponteiro para o mesmo GUID que foi especificado quando o aplicativo chamou FwpmProviderContextAdd0 para esse objeto.
[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.
Valor retornado
Tipo: DWORD
| Valor/código retornado | Descrição |
|---|---|
|
O descritor de segurança foi recuperado com êxito. |
|
Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro do WFP para obter detalhes. |
|
Falha ao se comunicar com o mecanismo de firewall remoto ou local. |
Comentários
Se o parâmetro de chave for NULL ou se for um GUID NULL , essa função gerenciará as informações de segurança do contêiner de contextos do provedor.
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 .
FwpmProviderContextGetSecurityInfoByKey0 é uma implementação específica de FwpmProviderContextGetSecurityInfoByKey. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.
Requisitos
| 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 |