Método CHString::GetBuffer (chstring.h)
[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 GetBuffer retorna um ponteiro para o buffer de caracteres interno do objeto CHString .
Sintaxe
LPWSTR throw(CHeap_Exception) GetBuffer(
int nMinBufLength
);
Parâmetros
nMinBufLength
O tamanho mínimo do buffer de caracteres em caracteres. Esse valor não inclui espaço para um terminador NULL .
Retornar valor
Um ponteiro LPWSTR para o buffer de caracteres do objeto (terminado em NULL).
Comentários
O LPWSTR retornado não é const e, portanto, permite a modificação direta do conteúdo CHString .
Se você usar o ponteiro retornado por GetBuffer para alterar o conteúdo da cadeia de caracteres, deverá chamar ReleaseBuffer antes de usar qualquer outro método CHString .
Após uma chamada para ReleaseBuffer, o endereço retornado por GetBuffer pode não ser válido porque operações adicionais do CHString podem fazer com que o buffer CHString seja realocado. Se você não alterar o comprimento da cadeia de caracteres CHString , o buffer não será realocado. A memória do buffer é liberada automaticamente quando o objeto CHString é destruído.
Observe que, se você manter o controle do comprimento da cadeia de caracteres por conta própria, não deverá acrescentar o caractere NULL de terminação. No entanto, você deve especificar o comprimento final da cadeia de caracteres ao liberar o buffer com ReleaseBuffer. Se você acrescentar um caractere NULL de terminação, deverá passar –1 para o comprimento para ReleaseBuffer, que chama wcslen no buffer para determinar seu comprimento.
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 |