Funzione ClfsMgmtSetLogFileSizeAsClient (wdm.h)

Articolo
02/07/2025

La routine ClfsMgmtSetLogFileSizeAsClient imposta le dimensioni del file di log aggiungendo contenitori a un log client o eliminando contenitori da un log client.

Sintassi

CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSizeAsClient(
  [in]            PLOG_FILE_OBJECT                     LogFile,
  [in, optional]  CLFS_MGMT_CLIENT                     ClientCookie,
  [in]            PULONGLONG                           NewSizeInContainers,
  [out, optional] PULONGLONG                           ResultingSizeInContainers,
  [in, optional]  PCLFS_SET_LOG_SIZE_COMPLETE_CALLBACK CompletionRoutine,
  [in, optional]  PVOID                                CompletionRoutineData
);

Parametri

[in] LogFile

Puntatore a una struttura di LOG_FILE_OBJECT che rappresenta il log CLFS (Common Log File System) o un flusso all'interno del log, a cui vengono aggiunti o eliminati i contenitori. Il valore di questo parametro viene ottenuto tramite una chiamata alla routine ClfsCreateLogFile.

[in, optional] ClientCookie

Puntatore a un cookie fornito dal client. Il valore di questo parametro deve essere la struttura CLFS_MGMT_CLIENT ottenuta tramite una chiamata alla routine ClfsMgmtRegisterManagedClient.

[in] NewSizeInContainers

Dimensioni desiderate del log, espresse nel numero di contenitori. Per un file di log possono essere presenti al massimo 1.024 contenitori.

[out, optional] ResultingSizeInContainers

Dimensione effettiva del log, espressa nel numero di contenitori.

[in, optional] CompletionRoutine

Non utilizzato.

[in, optional] CompletionRoutineData

Non utilizzato.

Valore restituito

La routine ClfsMgmtSetLogFileSizeAsClient restituisce un valore NTSTATUS.

Codice restituito	Descrizione
STATUS_SUCCESS	Le dimensioni del file di log sono state impostate.
STATUS_INVALID_PARAMETER_1	Il valore del parametro LogFile è NULLo il contenuto del parametro NewSizeInContainers è 1.
STATUS_INVALID_PARAMETER_2	Il valore del parametro NewSizeInContainers è NULL.
STATUS_LOG_POLICY_INVALID	Il set di criteri installato nel log non è valido. Questo potrebbe essere dovuto a un criterio di ClfsMgmtPolicyAutoShrink o a criteri clfsMgmtPolicyMaximumSize.
STATUS_COULD_NOT_RESIZE_LOG	La gestione CLFS non è stata in grado di eliminare contenitori sufficienti per raggiungere il valore in NewSizeInContainers.
STATUS_LOG_POLICY_CONFLICT	Un criterio nel log specificato ha impedito il completamento dell'operazione. Ciò può verificarsi se la gestione CLFS non è riuscita ad aggiungere contenitori sufficienti al log per raggiungere il valore in NewSizeInContainers. Ciò potrebbe essere dovuto a un conflitto con un criterio impostato dal client.

Questa routine potrebbe restituire anche altri valori NTSTATUS .

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows 7 e versioni successive di Windows.
piattaforma di destinazione	Desktop
intestazione	wdm.h
dll	Clfs.sys

Vedere anche

routine della libreria di gestione CLFS

Condividi tramite