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 |
---|---|
|
A política foi instalada. |
|
Um valor de NULL foi fornecido para o parâmetro LogFile. |
|
Um valor de NULL foi fornecido para o parâmetro de Política de. |
|
O valor do parâmetro PolicyLength é menor que o tamanho de uma instância da estrutura CLFS_MGMT_POLICY. |
|
O PolicyFlags membro do CLFS_MGMT_POLICY_STRUCTURE apontado pelo parâmetro de Política de especifica qualquer sinalizador diferente de LOG_POLICY_OVERWRITE. |
|
Uma das seguintes condições é verdadeira:
|
|
O log já tem uma política desse tipo e o sinalizador de LOG_POLICY_OVERWRITE não está definido. |
|
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 |