Metodo ILog::Force (txlogpub.h)
Forza il contenuto del log su disco, almeno fino all'LSN specificato.
Sintassi
HRESULT Force(
[in] LSN lsnMinToForce
);
Parametri
[in] lsnMinToForce
Almeno, tutti i record che non sono ancora stati scritti su disco con un LSN minore o uguale a lsnMinToForce devono essere scritti su disco ora. Un'implementazione può tuttavia scegliere di scrivere più record rispetto a quelli strettamente necessari. Ad esempio, un'implementazione può forzare tutti i record su disco, indipendentemente dal valore di lsnMinToForce. Passando 0 come lsnMinToForce indica che l'intero log deve essere forzato su disco.
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Il log può essere forzato anche su disco dopo l'aggiunta di singoli record. Vedere ILog::AppendRecord.
Note ai chiamanti
Un valore restituito di errore indica che tutti i record aggiunti al log dall'ultima volta che è stato forzato non sono garantiti sul disco. L'interfaccia ILog non fornisce un metodo per determinare quali record sono stati scritti correttamente su disco. Se è necessario sapere quali record sono stati scritti correttamente su disco, è necessario forzare il log per ogni record. Vedere ILog::AppendRecord.Note per gli implementatori
È consigliabile scaricare i buffer dei file, ad esempio usando la funzione FlushFileBuffers , prima di restituire da questo metodo.Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | txlogpub.h |