SysAllocStringLen
.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 aloca um novo seqüência de caracteres, cópias cch caracteres a partir de seqüência de caracteres passado para ela e, em seguida, anexa um NULL caractere.
Syntax
BSTR SysAllocStringLen(
OLECHAR FAR* pch,
unsigned int cch
);
Parameters
- 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
Um ponteiro para uma copiar do seqüência de caracteres indica sucesso.
NULL Indica que existe memória suficiente.
Remarks
Se pch é NULL, um seqüência de caracteres o comprimento solicitado está alocado, mas não inicializado.
O pch seqüência de caracteres podem conter incorporado NULL caracteres e não precisa terminar com um NULL.
Liberar o seqüência de caracteres retornado posteriormente com SysFreeString.
Windows Embedded CE e Windows Mobile suporte somente seqüências Unicode.
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 |