Compartilhar via


Função SysAllocStringLen (oleauto.h)

Aloca uma nova cadeia de caracteres, copia o número especificado de caracteres da cadeia de caracteres passada e acrescenta um caractere de terminação nula.

Sintaxe

BSTR SysAllocStringLen(
  [in] const OLECHAR *strIn,
  [in] UINT          ui
);

Parâmetros

[in] strIn

A cadeia de caracteres de entrada.

[in] ui

O número de caracteres a serem copiados. Um caractere nulo é colocado posteriormente, alocando um total de interface do usuário mais um caractere.

Retornar valor

Uma cópia da cadeia de caracteres ou NULL se não houver memória suficiente para concluir a operação.

Comentários

A cadeia de caracteres pode conter caracteres nulos inseridos e não precisa terminar com um NULL. Libere a cadeia de caracteres retornada mais tarde com SysFreeString. Se strIn não for NULL, a memória alocada para strIn deverá ter pelo menos caracteres de interface do usuário.

Nota Essa função não converte uma cadeia de caracteres char * em um BSTR Unicode.
 

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oleauto.h
Biblioteca OleAut32.lib
DLL OleAut32.dll

Confira também

Funções de manipulação de cadeia de caracteres