Funzione RemoveLogContainerSet (clfsw32.h)

Rimuove più contenitori da un log associato a un handle di log dedicato o multiplexed.

Un client deve disporre di privilegi amministrativi per l'handle di log per rimuovere un contenitore. La funzione RemoveLogContainer è un caso speciale di questa funzione RemoveLogContainerSet , perché rimuove un solo contenitore. Per rimuovere più contenitori, usare RemoveLogContainerSet.

Sintassi

CLFSUSER_API BOOL RemoveLogContainerSet(
  [in]                HANDLE hLog,
  [in]                USHORT cContainer,
  [in]                LPWSTR *rgwszContainerPath,
  [in]                BOOL   fForce,
  [in, out, optional] LPVOID pReserved
);

Parametri

[in] hLog

Handle per il log ottenuto da CreateLogFile.

L'handle di log deve disporre dell'autorizzazione amministrativa per aggiungere un contenitore di log e può fare riferimento a un log dedicato o multiplexed.

[in] cContainer

Numero di nomi di percorso del contenitore in una matrice a cui punta rgwszContainerPath.

Questo valore deve essere diverso da zero.

[in] rgwszContainerPath

Matrice di puntatori ai nomi dei percorsi del contenitore che contengono puntatori cContainers .

Ogni nome di percorso è una stringa di caratteri wide che identifica un contenitore creato da AddLogContainer o AddLogContainerSet.

[in] fForce

Flag di eliminazione che determina quando e come viene eliminato un contenitore.

Se fForce è TRUE e il contenitore fa parte dell'area di log attiva, il contenitore non viene eliminato e viene restituito un errore ERROR_LOG_CANT_DELETE .

Se FALSE, il contenitore viene eliminato quando il contenitore non fa più parte dell'area di log attiva.

[in, out, optional] pReserved

Riservato. Impostare pReserved suNULL.

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 informazioni dettagliate sull'errore, chiamare GetLastError.

L'elenco seguente identifica i possibili codici di errore:

Commenti

Per impostazione predefinita, l'eliminazione del contenitore è differita, il che significa che un contenitore viene eliminato solo se non fa parte del log attivo. Se il contenitore fa parte del log attivo, viene contrassegnato per l'eliminazione. Questa eliminazione viene posticipata fino a quando la parte finale del log supera l'ultimo settore del contenitore o il contenitore ha un identificatore logico maggiore dell'identificatore logico dell'intestazione del log attivo. Le dimensioni del log riflettono l'eliminazione del contenitore solo quando il contenitore viene eliminato fisicamente.

Un client di log può richiedere un'eliminazione forzata in un contenitore impostando il flag di eliminazione su TRUE. Ciò ha lo stesso effetto dell'eliminazione di un contenitore che non fa parte del log attivo. Tuttavia, se un contenitore fa parte del log attivo, la chiamata non riesce senza contrassegnare il contenitore per l'eliminazione.

Requisiti

Vedi anche

AddLogContainer

AddLogContainerSet

Funzioni comuni del file system di log

SOVRAPPOSTA

RemoveLogContainer