Metodo CHString::GetBuffer (chstring.h)

[La classe CHString fa parte di WMI Provider Framework, che viene ora considerata in stato finale e non saranno disponibili ulteriori sviluppi, 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 GetBuffer restituisce un puntatore al buffer dei caratteri interno per l'oggetto CHString .

Sintassi

LPWSTR  throw(CHeap_Exception) GetBuffer(
  int nMinBufLength
);

Parametri

nMinBufLength

Dimensioni minime del buffer di caratteri in caratteri. Questo valore non include spazio per un carattere di terminazione NULL .

Valore restituito

Puntatore LPWSTR al buffer di caratteri (con terminazione NULL) dell'oggetto.

Commenti

LPWSTR restituito non è const e pertanto consente la modifica diretta del contenuto CHString.

Se si usa il puntatore restituito da GetBuffer per modificare il contenuto della stringa, è necessario chiamare ReleaseBuffer prima di usare qualsiasi altro metodo CHString .

Dopo una chiamata a ReleaseBuffer, l'indirizzo restituito da GetBuffer potrebbe non essere valido perché altre operazioni CHString possono causare la riallocazione del buffer CHString . Se non si modifica la lunghezza della stringa CHString , il buffer non viene riallocato. La memoria buffer viene liberata automaticamente quando l'oggetto CHString viene eliminato definitivamente.

Si noti che se si tiene traccia della lunghezza della stringa manualmente, non è consigliabile aggiungere il carattere NULL di terminazione. È tuttavia necessario specificare la lunghezza finale della stringa quando si rilascia il buffer con ReleaseBuffer. Se si aggiunge un carattere NULL di terminazione, è necessario passare –1 per la lunghezza a ReleaseBuffer, che chiama wcslen nel buffer per determinarne la lunghezza.

Requisiti

Vedi anche

CHString

CHString::GetBufferSetLength

CHString::ReleaseBuffer