Compartir a través de

Función ClfsMgmtInstallPolicy (wdm.h)

  • Artículo

La rutina ClfsMgmtInstallPolicy agrega una estructura de CLFS_MGMT_POLICY a un registro físico.

Sintaxis

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

Parámetros

[in] LogFile

Puntero a una estructura de LOG_FILE_OBJECT que representa el registro CLFS al que se aplicará esta instancia de la estructura CLFS_MGMT_POLICY . La directiva se aplica a todas las secuencias del registro, incluso si se especificó una sola secuencia dentro del registro.

[in] Policy

Puntero a una estructura de CLFS_MGMT_POLICY que contiene la directiva que se va a instalar.

[in] PolicyLength

Longitud, en bytes, de la estructura a la que apunta el parámetro Policy .

Valor devuelto

La rutina ClfsMgmtInstallPolicy devuelve uno de los siguientes valores NTSTATUS:

Código devuelto Descripción
STATUS_SUCCESS
 La directiva se ha instalado.
STATUS_INVALID_PARAMETER_1
 Se proporcionó un valor NULL para el parámetro LogFile .
STATUS_INVALID_PARAMETER_2
 Se proporcionó un valor NULL para el parámetro Policy .
STATUS_INVALID_PARAMETER_3
 El valor del parámetro PolicyLength es menor que el tamaño de una instancia de la estructura CLFS_MGMT_POLICY .
STATUS_NOT_SUPPORTED
 El miembro PolicyFlags del CLFS_MGMT_POLICY_STRUCTURE apuntado por el parámetro Policy especifica cualquier marca que no sea LOG_POLICY_OVERWRITE.
STATUS_INVALID_PARAMETER
 Se cumple alguna de las siguientes condiciones:
  • El miembro Version del parámetro Policy no es igual a CLFS_MGMT_POLICY_VERSION.
  • El valor del parámetro Policy es igual a ClfsMgmtPolicyInvalid.
  • El miembro PolicyFlags del parámetro Policy especifica cualquier marca que no sea LOG_POLICY_OVERWRITE.
STATUS_LOG_POLICY_ALREADY_INSTALLED
 El registro ya tiene una directiva de este tipo y la marca de LOG_POLICY_OVERWRITE no está establecida.
STATUS_INSUFFICIENT_RESOURCES
 No hay memoria suficiente para completar la operación.
 

Esta rutina también podría devolver otros valores NTSTATUS.

Comentarios

Las directivas son volátiles. Cuando se cierran todos los identificadores del registro, se perderán las directivas. Debe instalar directivas cada vez que registre el primer cliente.

Solo debe registrar una estructura de CLFS_MGMT_POLICY cuyo miembro PolicyType sea igual a ClfsMgmtPolicyNewContainerSize antes de crear el primer contenedor del registro. Se omiten los registros posteriores.

La directiva de registro que se instala se aplica al registro físico, incluso si el parámetro LogFile especifica un flujo de registro.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library Clfs.lib
Archivo DLL Clfs.sys
IRQL <= APC_LEVEL

Consulte también

CLFS_MGMT_POLICY