Função FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)

Artigo
08/07/2023

A função FwpsAcquireWritableLayerDataPointer0 retorna dados específicos da camada que podem ser inspecionados e alterados.

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

Sintaxe

NTSTATUS FwpsAcquireWritableLayerDataPointer0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [out]     PVOID              *writableLayerData,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

Parâmetros

[in] classifyHandle

Um identificador para a solicitação de classificação. Esse identificador é obtido chamando FwpsAcquireClassifyHandle0.

[in] filterId

O valor do membro FilterId do parâmetro de filtro da função classifyFn. Para obter mais informações sobre o membro FilterId , consulte FWPS_FILTER1.

[in] flags

Reservado para uso futuro. Defina como zero.

[out] writableLayerData

Um buffer de dados que contém os dados modificáveis para a camada. Os tipos de dados com suporte, listados na seção Comentários a seguir, são definidos como estruturas. No retorno, os dados podem ser acessados convertendo o ponteiro void para o tipo de estrutura apropriado.

[in, out] classifyOut

Defina como o parâmetro classifyOut da função classifyFn do driver de texto explicativo. O parâmetro classifyOut de classifyFn é listado como um parâmetro de saída no cabeçalho, mas contém informações suficientes sobre a entrada para ser útil para o mecanismo quando passado para FwpsAcquireWritableLayerDataPointer0.

Retornar valor

A função FwpsAcquireWritableLayerDataPointer0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	A função de retorno de chamada foi registrada com êxito.
Outros códigos status	Ocorreu um erro.

Comentários

FwpsAcquireWritableLayerDataPointer0 define os seguintes membros da estrutura FWPS_CLASSIFY_OUT0 :

classifyOut->actionType = FWP_ACTION_BLOCK
classifyOut->&de direitos = ~FWPS_RIGHT_ACTION_WRITE

Para cada chamada para essa função, você deve fazer uma chamada correspondente para FwpsApplyModifiedLayerData0 para finalizar as alterações que foram feitas, mesmo que o driver de texto explicativo não tenha modificado nenhum dado. Se você não fizer a chamada para FwpsApplyModifiedLayerData0, isso poderá resultar na classificação não concluída corretamente.

As estruturas a seguir são definidas para conter dados de camada modificáveis. O ponteiro definido na saída como o parâmetro writableLayerData pode ser convertido em um destes tipos:

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 7.
Plataforma de Destino	Universal
Cabeçalho	fwpsk.h (inclua Fwpsk.h)
Biblioteca	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL