SysAllocString
.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 e copia o seqüência de caracteres passado para ela. Essa função retorna NULL se não há memória suficiente ou se um ponteiro nulo é passado.
Syntax
BSTR SysAllocString(
OLECHAR FAR* sz
);
Parameters
- SZ
[no] Seqüência de caracteres NULL-Terminated para copiar. O seqüência de caracteres devem ser um seqüência de caracteres Unicode em 32 - bit aplicativos e um seqüência ANSI em 16 - bit aplicativos.
Return Value
Retorna o seqüência de caracteres alocado para indicar êxito, ou NULL para indicar que existe memória suficiente ou que o SZ parâmetro foi NULL.
Remarks
Windows Embedded CE e Windows Mobile suporte somente Unicode seqüências.
Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.
Você pode livre criadas com seqüências de caracteres SysAllocString Usando SysFreeString.
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 |