Método CHString::LockBuffer (chstring.h)

[La clase CHString forma parte del marco del proveedor de WMI que ahora se considera en estado final y no habrá más desarrollo, mejoras ni actualizaciones disponibles para problemas no relacionados con la seguridad que afecten a estas bibliotecas. Las API de MI deben usarse para todo el desarrollo nuevo.]

El método LockBuffer bloquea una cadena en el búfer.

Sintaxis

LPWSTR LockBuffer();

Valor devuelto

Devuelve un puntero a un objeto CHString o a una cadena terminada en NULL.

Comentarios

Al llamar a LockBuffer, se crea una copia de la cadena y, a continuación, se establece el recuento de referencias en -1.

Cuando el recuento de referencias se establece en -1, la cadena del búfer se considera que está en un estado bloqueado, que protege la cadena de las dos maneras siguientes:

• Ninguna otra cadena puede obtener una referencia a los datos de la cadena bloqueada, incluso si esa cadena está asignada a la cadena bloqueada.
• La cadena bloqueada nunca hace referencia a otra cadena, incluso si esa otra cadena se copia en la cadena bloqueada.

Cuando haya terminado con LockBuffer, llame a UnlockBuffer para restablecer el recuento de referencias a 1 (uno).

Requisitos

Consulte también

CHString

CHString::UnlockBuffer