Função ClfsMgmtInstallPolicy (wdm.h)

  • Artigo

A rotina ClfsMgmtInstallPolicy adiciona uma estrutura CLFS_MGMT_POLICY a um log físico.

Sintaxe

CLFSUSER_API NTSTATUS ClfsMgmtInstallPolicy(
  [in] PLOG_FILE_OBJECT  LogFile,
  [in] PCLFS_MGMT_POLICY Policy,
  [in] ULONG             PolicyLength
);

Parâmetros

[in] LogFile

Um ponteiro para uma estrutura LOG_FILE_OBJECT que representa o log CLFS ao qual essa instância da estrutura CLFS_MGMT_POLICY será aplicada. A política se aplica a todos os fluxos dentro do log, mesmo que um único fluxo dentro do log tenha sido especificado.

[in] Policy

Um ponteiro para uma estrutura CLFS_MGMT_POLICY que contém a política a ser instalada.

[in] PolicyLength

O comprimento, em bytes, da estrutura apontada pelo parâmetro Policy .

Retornar valor

A rotina ClfsMgmtInstallPolicy retorna um dos seguintes valores NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
 A política foi instalada.
STATUS_INVALID_PARAMETER_1
 Um valor NULL foi fornecido para o parâmetro LogFile .
STATUS_INVALID_PARAMETER_2
 Um valor NULL foi fornecido para o parâmetro Policy .
STATUS_INVALID_PARAMETER_3
 O valor do parâmetro PolicyLength é menor que o tamanho de uma instância da estrutura CLFS_MGMT_POLICY .
STATUS_NOT_SUPPORTED
 O membro PolicyFlags do CLFS_MGMT_POLICY_STRUCTURE apontado pelo parâmetro Policy especifica qualquer sinalizador diferente de LOG_POLICY_OVERWRITE.
STATUS_INVALID_PARAMETER
 Uma das seguintes condições é verdadeira:
  • O membro Version do parâmetro Policy não é igual a CLFS_MGMT_POLICY_VERSION.
  • O valor do parâmetro Policy é igual a ClfsMgmtPolicyInvalid.
  • O membro PolicyFlags do parâmetro Policy especifica qualquer sinalizador diferente de LOG_POLICY_OVERWRITE.
STATUS_LOG_POLICY_ALREADY_INSTALLED
 O log já tem uma política desse tipo e o sinalizador LOG_POLICY_OVERWRITE não está definido.
STATUS_INSUFFICIENT_RESOURCES
 Não há memória suficiente para concluir a operação.
 

Essa rotina também pode retornar outros valores NTSTATUS.

Comentários

As políticas são voláteis. Quando todos os identificadores para o log forem fechados, as políticas serão perdidas. Você deve instalar políticas sempre que registrar o primeiro cliente.

Você só deve registrar uma estrutura CLFS_MGMT_POLICY cujo membro PolicyType seja igual a ClfsMgmtPolicyNewContainerSize antes que o primeiro contêiner no log seja criado. Todos os registros subsequentes são ignorados.

A política de log instalada se aplica ao log físico, mesmo que o parâmetro LogFile especifique um fluxo de log.

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