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
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 |