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.

Al bloquear la cadena en el búfer, se asegura de que la suspensión exclusiva de la cadena en el búfer permanece intacta.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	chstring.h (incluya FwCommon.h)
Library	FrameDyn.lib
Archivo DLL	FrameDynOS.dll; FrameDyn.dll

Consulte también

CHString

CHString::UnlockBuffer