Compartilhar via


Função ClfsMgmtInstallPolicy (wdm.h)

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