Funzione ClfsMgmtInstallPolicy (wdm.h)

Articolo
02/29/2024

La routine ClfsMgmtInstallPolicy aggiunge una struttura CLFS_MGMT_POLICY a un log fisico.

Sintassi

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

Parametri

[in] LogFile

Puntatore a una struttura LOG_FILE_OBJECT che rappresenta il log CLFS a cui verrà applicata questa istanza della struttura CLFS_MGMT_POLICY . Il criterio si applica a tutti i flussi all'interno del log, anche se è stato specificato un singolo flusso all'interno del log.

[in] Policy

Puntatore a una struttura CLFS_MGMT_POLICY che contiene i criteri da installare.

[in] PolicyLength

Lunghezza, in byte, della struttura a cui fa riferimento il parametro Policy .

Valore restituito

La routine ClfsMgmtInstallPolicy restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il criterio è stato installato.
STATUS_INVALID_PARAMETER_1	È stato fornito un valore NULL per il parametro LogFile .
STATUS_INVALID_PARAMETER_2	È stato fornito un valore NULL per il parametro Policy .
STATUS_INVALID_PARAMETER_3	Il valore del parametro PolicyLength è minore delle dimensioni di un'istanza della struttura CLFS_MGMT_POLICY .
STATUS_NOT_SUPPORTED	Il membro PolicyFlags del CLFS_MGMT_POLICY_STRUCTURE indicato dal parametro Policy specifica qualsiasi flag diverso da LOG_POLICY_OVERWRITE.
STATUS_INVALID_PARAMETER	una delle condizioni seguenti è vera: Il membro Version del parametro Policy non è uguale a CLFS_MGMT_POLICY_VERSION. Il valore del parametro Policy è uguale a ClfsMgmtPolicyInvalid. Il membro PolicyFlags del parametro PolicyFlags specifica qualsiasi flag diverso da LOG_POLICY_OVERWRITE.
STATUS_LOG_POLICY_ALREADY_INSTALLED	Il log ha già un criterio di questo tipo e il flag di LOG_POLICY_OVERWRITE non è impostato.
STATUS_INSUFFICIENT_RESOURCES	Memoria insufficiente per completare l'operazione.

Questa routine potrebbe anche restituire altri valori NTSTATUS.

Commenti

I criteri sono volatili. Quando tutti gli handle del log vengono chiusi, i criteri verranno persi. È consigliabile installare i criteri ogni volta che si registra il primo client.

È consigliabile registrare una struttura CLFS_MGMT_POLICY il cui membro PolicyType è uguale a ClfsMgmtPolicyNewContainerSize prima della creazione del primo contenitore nel log. Tutte le registrazioni successive vengono ignorate.

I criteri di log installati si applicano al log fisico, anche se il parametro LogFile specifica un flusso di log.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Server 2003 R2, Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Vedi anche

CLFS_MGMT_POLICY

Condividi tramite