Função ClfsMgmtQueryPolicy (wdm.h)

Artigo
02/07/2025

A rotina de ClfsMgmtQueryPolicy recupera uma estrutura de CLFS_MGMT_POLICY específica para um log.

Sintaxe

CLFSUSER_API NTSTATUS ClfsMgmtQueryPolicy(
  [in]  PLOG_FILE_OBJECT      LogFile,
  [in]  CLFS_MGMT_POLICY_TYPE PolicyType,
  [out] PCLFS_MGMT_POLICY     Policy,
  [out] PULONG                PolicyLength
);

Parâmetros

[in] LogFile

Um ponteiro para uma estrutura LOG_FILE_OBJECT que representa o log CLFS cuja política está sendo recuperada.

[in] PolicyType

Um valor da enumeração CLFS_MGMT_POLICY_TYPE que identifica o tipo de política a ser recuperada.

[out] Policy

Uma instância da estrutura CLFS_MGMT_POLICY que contém a política.

[out] PolicyLength

O comprimento do parâmetro de Política de.

Valor de retorno

A rotina de ClfsMgmtQueryPolicy retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	O gerenciamento CLFS recuperou a política solicitada.
STATUS_UNSUCCESSFUL	O gerenciamento do CLFS não pôde processar a solicitação.
STATUS_INVALID_PARAMETER	O valor do parâmetro PolicyType não é válido para a enumeração CLFS_MGMT_POLICY_TYPE.
STATUS_INVALID_PARAMETER_1	Um valor de NULL foi fornecido para o parâmetro LogFile.
STATUS_INVALID_PARAMETER_2	O valor do parâmetro PolicyLength é menor que o tamanho de uma instância da estrutura CLFS_MGMT_POLICY.
STATUS_INSUFFICIENT_RESOURCES	Não há memória suficiente para concluir a operação.
STATUS_LOG_POLICY_NOT_INSTALLED	Nenhuma política desse tipo foi registrada para o arquivo de log.

Essa rotina também pode retornar outros NTSTATUS Values.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca	Clfs.lib
de DLL	Clfs.sys
IRQL	<= APC_LEVEL

Consulte também

CLFS_MGMT_POLICY

CLFS_MGMT_POLICY_TYPE

Compartilhar via