Função ClfsMgmtInstallPolicy (wdm.h)

Artigo
02/07/2025

A rotina de 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 de 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 de CLFS_MGMT_POLICY que contém a política a ser instalada.

[in] PolicyLength

O comprimento, em bytes, da estrutura apontada pelo parâmetro de Política de.

Valor de retorno

A rotina de ClfsMgmtInstallPolicy do 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 de NULL foi fornecido para o parâmetro LogFile.
STATUS_INVALID_PARAMETER_2	Um valor de NULL foi fornecido para o parâmetro de Política de.
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 PolicyFlags membro do CLFS_MGMT_POLICY_STRUCTURE apontado pelo parâmetro de Política de especifica qualquer sinalizador diferente de LOG_POLICY_OVERWRITE.
STATUS_INVALID_PARAMETER	Uma das seguintes condições é verdadeira: O membro de versão do parâmetro de Política de não é igual a CLFS_MGMT_POLICY_VERSION. O valor do parâmetro Policy é igual a ClfsMgmtPolicyInvalid. O do parâmetro Policy do PolicyFlags 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 de 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 NTSTATUS Values.

Observações

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ê deve registrar apenas uma estrutura CLFS_MGMT_POLICY cujo membro PolicyType é igual a ClfsMgmtPolicyNewContainerSize antes da criação do primeiro contêiner no log. 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
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

Compartilhar via