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.
Bloccando la stringa nel buffer, assicurarsi che il blocco esclusivo della stringa nel buffer rimanga intatto.

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

Vedi anche

CHString

CHString::UnlockBuffer