Função ClfsMgmtQueryPolicy (wdm.h)

  • Artigo

A rotina 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 Policy .

Retornar valor

A rotina 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 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 valores NTSTATUS.

Requisitos

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

Confira também

CLFS_MGMT_POLICY

CLFS_MGMT_POLICY_TYPE