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 |