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
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | clfsw32.h |
| Libreria | Clfsw32.lib |
| DLL | Clfsw32.dll |