SysReAllocStringLen
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função cria um BSTR que contém um número especificado de caracteres de um antigo BSTRe libera o antigo BSTR.
Syntax
HRESULT SysReAllocStringLen(
BSTR FAR* pbstr,
OLECHAR FAR* pch,
unsigned int cch
);
Parameters
- pbstr
[out] Ponteiro para um seqüência de caracteres.
- pch
[no] Ponteiro para cch Caracteres para copiar, ou NULL para manter o não inicializado seqüência de caracteres.
- cch
[no] Número de caracteres para copiar a partir pch. Um NULL caractere é colocado posteriormente, alocar um total de cch+ 1 caracteres.
Return Value
Retorna um valor HRESULT.
Remarks
O SysReAllocStringLen função faz o seguinte:
- Aloca um novo seqüência de caracteres
- Cópias cch caracteres da seqüência de caracteres passado para ela
- Acrescenta uma NULL caractere
- Libera o BSTR relacionado por pbstr
- Redefine pbstr Para apontar para o novo BSTR
Se pch é NULL, um seqüência de caracteres de comprimento cch é alocada mas não inicializado.
O pch seqüência de caracteres podem conter incorporado NULL caracteres e não precisa terminar com um NULL.
Apenas seqüências de caracteres Unicode com suporte.
Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.
Requirements
| Header | oleauto.h |
| Library | oleaut32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |