Funzione SetLogFileSizeWithPolicy (clfsmgmtw32.h)

  • Articolo

Aggiunge o elimina i contenitori da un log in base allo stato dei criteri installati.

Sintassi

CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
  [in]  HANDLE     hLog,
  [in]  PULONGLONG pDesiredSize,
  [out] PULONGLONG pResultingSize
);

Parametri

[in] hLog

Handle in un log.

[in] pDesiredSize

Puntatore a un valore che specifica le dimensioni del log richieste, espresse come uno dei valori seguenti. Per le dimensioni effettive risultanti, fare riferimento al parametro pResultingSize .

Valore Significato
0
 Applicare i criteri di dimensione minima.

Se non è installato un criterio di dimensione minima, si verifica uno dei seguenti elementi:

  • Se il log ha meno di due contenitori, il log verrà espanso in una dimensione di due contenitori.
  • Se il log ha due o più contenitori, non vengono apportate modifiche e la chiamata alla funzione ha esito positivo.

Se viene installato un criterio di dimensione minima, si verifica uno dei seguenti elementi:

  • Se il log ha meno del numero minimo di contenitori specificati dai criteri di dimensione minima, il log si espande al numero minimo di contenitori specificato dai criteri.
  • Se il log ha un numero di contenitori maggiore o uguale al numero minimo di contenitori specificati dai criteri di dimensione minima, non vengono apportate modifiche e la chiamata di funzione non riesce senza errori.

Per altre informazioni, vedere InstallLogPolicy.
1
 Non un valore valido; la chiamata alla funzione ha esito negativo con ERROR_INVALID_PARAMETER.
2–1023
 Dimensione desiderata del log, espressa come numero di contenitori.

Se questo numero è inferiore al numero minimo di contenitori specificati dal criterio installato, la chiamata alla funzione ha esito negativo con ERROR_COULD_NOT_RESIZE_LOG.

Se questo numero è maggiore del numero massimo di contenitori specificati dal criterio installato, il log si espande solo per quanto riguarda il numero massimo specificato dai criteri e la funzione ha esito positivo senza errori.
1024–MAXULONGLONGLONG
 Se non vengono installati criteri di dimensione massima, la chiamata alla funzione non riesce con ERROR_LOG_POLICY_CONFLICT.

Se viene installato un criterio di dimensione massima, il log si espande al numero massimo di contenitori specificati dai criteri di dimensione massima e la funzione non riesce con alcun errore.

[out] pResultingSize

Un puntatore a una variabile di dati ULONGLONG valida riceve il numero di contenitori nel log ridimensionato al termine dell'esito positivo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Commenti

I contenitori vengono creati usando gli stessi attributi di sicurezza del file blf e vengono creati nel contesto dell'applicazione, non il contesto del proprietario del file Blf. Per altre informazioni sui file blf, vedere Tipi di log. Se i contenitori vengono eliminati, vengono eliminati usando il contesto di sicurezza dell'applicazione chiamante.

Esempio

Per un esempio che usa questa funzione, vedere Creazione di un file di log.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione clfsmgmtw32.h
Libreria Clfsw32.lib
DLL Clfsw32.dll

Vedi anche

Creazione di un file di log

InstallLogPolicy

Tipi di log