Funzione RemoveLogContainer (clfsw32.h)
Rimuove un contenitore 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. Per rimuovere più contenitori, usare la funzione RemoveLogContainerSet .
Sintassi
CLFSUSER_API BOOL RemoveLogContainer(
[in] HANDLE hLog,
[in] LPWSTR pwszContainerPath,
[in] BOOL fForce,
[in, out, optional] LPVOID pReserved
);
Parametri
[in] hLog
Handle per il log ottenuto da CreateLogFile.
[in] pwszContainerPath
Puntatore a una stringa di caratteri wide che contiene un percorso per un contenitore di log 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
Questo parametro è riservato e deve essere impostato su NULL.
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 di un log attivo. Se il contenitore fa parte del log attivo, viene contrassegnato per l'eliminazione. Tuttavia, l'eliminazione non si verifica fino alla fine del log supera l'ultimo settore del contenitore oppure 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 il contenitore fa parte del log attivo, la chiamata non riesce senza contrassegnare il contenitore per l'eliminazione.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |