CString::LockBuffer

LPTSTR LockBuffer);

Valor de retorno

Um ponteiro para um objeto de CString ou uma NULL-finalizada seqüência de caracteres.

Observações

Chame essa função de membro para bloquear uma Cadeia de caracteres no buffer.

Chama&ndo LockBuffer, você cria uma Copiar da Cadeia de caracteres e, em seguida, definir a contagem de referência para -1. Quando o contagem de referência é definido como -1, a Cadeia de caracteres no buffer é considerada em uma state.nbsp "bloqueado"; Enquanto em um estado bloqueado, a Cadeia de caracteres é protegida de duas maneiras:

• Nenhuma outra Cadeia de caracteres pode obter uma referência para os dados na cadeia de caracteres bloqueada, mesmo se essa Cadeia de caracteres é atribuída à seqüência de caracteres bloqueada.
  
  
• A Cadeia de caracteres bloqueada nunca fará referência a outra Cadeia de caracteres, mesmo se essa Cadeia de caracteres é copiada para a Cadeia de caracteres bloqueada.

Travando a Cadeia de caracteres no buffer, você garantir que mantenha exclusiva do seqüência de caracteres no buffer permanecerão intacta.

Depois que você terminou com LockBuffer, chame UnlockBuffer para redefinir a contagem de referência para 1.

Para obter mais informações sobre a contagem de referência, consulte os seguintes artigos:

• Gerenciamento de vida útil de objeto através de contagem de referência na Referência do programador do Win32 SDK
  
  
• Implementação de referência contagem na Referência do programador do Win32 SDK
  
  
• Regras para gerenciar referência contagens na Referência do programador do Win32 SDK

Visão geral de CString |nbsp; Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CString::UnlockBuffer, CString::GetBuffer, CString::ReleaseBuffer