Compartilhar via


SysReAllocStringLen

Windows Mobile SupportedWindows Embedded CE Supported

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

See Also

Reference

Automation Functions
BSTR