Funzione ClfsMgmtSetLogFileSizeAsClient (wdm.h)

Articolo
02/27/2024

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

Dimensione desiderata del log, espressa 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 usato.

[in, optional] CompletionRoutineData

Non usato.

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 è NULL oppure 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. Ciò potrebbe essere dovuto a criteri ClfsMgmtPolicyAutoShrink o ClfsMgmtPolicyMaximumSize non validi.
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.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 7 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h
DLL	Clfs.sys

Vedi anche

Routine della libreria di gestione CLFS

Condividi tramite