SysStringLen
.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 recupera o comprimento de uma seqüência de caracteres.
Syntax
UINT SysStringLen(
BSTR bstr
);
Parameters
- BSTR
[no] Seqüência de caracteres Unicode que foi alocada anteriormente.
Return Value
O número de caracteres BSTR, não incluindo um caractere nulo de terminação, indica sucesso.
Se a pasta BSTR parâmetro é NULL, zero será retornado.
Remarks
O valor retornado pode ser diferente de (_fstrlenBSTR) se ocorreu o seguinte:
- Se BSTR Foi alocado com SysAllocStringLen, SysReAllocStringLen, ou SysAllocStringByteLen
- Se os caracteres passado incluído um NULL o primeiro caractere cch Caracteres
Para um BSTR alocado com SysAllocStringLen, SysAllocStringLen, ou SysAllocStringByteLen, o SysStringLen função recupera o número de caracteres especificados na cch parâmetro em tempo alocação.
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 |
See Also
Reference
Automation Functions
BSTR
SysAllocStringLen
SysReAllocStringLen
SysAllocStringByteLen