Compartilhar via

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

  • Artigo

[A classe CHString faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas em todos os novos desenvolvimentos.]

O método LockBuffer bloqueia uma cadeia de caracteres no buffer.

Sintaxe

LPWSTR LockBuffer();

Retornar valor

Retorna um ponteiro para um objeto CHString ou uma cadeia de caracteres terminada em NULL.

Comentários

Chamando LockBuffer, você cria uma cópia da cadeia de caracteres e, em seguida, define a contagem de referência como -1.

Quando a contagem de referência é definida como -1, a cadeia de caracteres no buffer é considerada em um estado bloqueado, que protege a cadeia de caracteres das duas maneiras a seguir:

  • Nenhuma outra cadeia de caracteres pode obter uma referência aos dados na cadeia de caracteres bloqueada, mesmo que essa cadeia de caracteres seja atribuída à cadeia de caracteres bloqueada.
  • A cadeia de caracteres bloqueada nunca faz referência a outra cadeia de caracteres, mesmo que essa outra cadeia de caracteres seja copiada para a cadeia de caracteres bloqueada.
Ao bloquear a cadeia de caracteres no buffer, você garante que a retenção exclusiva da cadeia de caracteres no buffer permaneça intacta.

Depois de terminar com o LockBuffer, chame UnlockBuffer para redefinir a contagem de referência para 1 (um).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho chstring.h (inclua FwCommon.h)
Biblioteca FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll

Confira também

CHString

CHString::UnlockBuffer