Metodo CHString::LockBuffer (chstring.h)
[La classe CHString fa parte di WMI Provider Framework che è ora considerata nello stato finale e non saranno disponibili ulteriori aggiornamenti, miglioramenti o aggiornamenti per problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.
Il metodo LockBuffer blocca una stringa nel buffer.
Sintassi
LPWSTR LockBuffer();
Valore restituito
Restituisce un puntatore a un oggetto CHString o a una stringa con terminazione NULL.
Commenti
Chiamando LockBuffer, si crea una copia della stringa e quindi si imposta il conteggio dei riferimenti su -1.
Quando il conteggio dei riferimenti è impostato su -1, la stringa nel buffer viene considerata in uno stato bloccato, che protegge la stringa nei due modi seguenti:
- Nessun'altra stringa può ottenere un riferimento ai dati nella stringa bloccata, anche se tale stringa viene assegnata alla stringa bloccata.
- La stringa bloccata non fa mai riferimento a un'altra stringa, anche se tale altra stringa viene copiata nella stringa bloccata.
Al termine di LockBuffer, chiamare UnlockBuffer per reimpostare il conteggio dei riferimenti a 1 (uno).
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Server minimo supportato | Windows Server 2008 |
Piattaforma di destinazione | Windows |
Intestazione | chstring.h (include FwCommon.h) |
Libreria | FrameDyn.lib |
DLL | FrameDynOS.dll; FrameDyn.dll |