VarUI2FromStr

9/8/2008

Essa função converte variante tipos dados para sem assinatura curtos de BSTR.

Syntax

WINOLEAUTAPI VarUI2FromStr(
  BSTR strIn, 
  LCID lcid, 
  ULONG dwFlags, 
  USHORT* puiOut 
);

Parameters

• strIn
  [no] O valor para coagir.

• LCID
  [no] Para conversões de seqüência de caracteres e VT_DISPATCH entrada, o LCID para a conversão.

• dwFlags
  [no] Um ou mais do seguinte sinalizadores.

  Sinalizador	Descrição
  LOCALE_NOUSEROVERRIDE	Usa o sistema usar como padrão localidade Configurações, em vez de personalizado configurações localidade.
  VAR_TIMEVALUEONLY	Omite a parte de uma VT_DATE de data e retorna somente o tempo. Aplica-se a conversão para ou de datas. Não usado para VariantChangeType e VariantChangeTypeEx.
  VAR_DATEVALUEONLY	Omite a parte tempo de uma VT_DATE e retorna apenas a data. Aplica-se a conversão para ou de datas. Não usado para VariantChangeType e VariantChangeTypeEx.

• puiOut
  [out] Aponta para o valor coagido.

Return Value

O seguinte valores HRESULT podem ser retornados.

Valor	Descrição
S_OK	O sucesso.
DISP_E_BADVARTYPE	O parâmetro de entrada não é válido um tipo de variante.
DISP_E_OVERFLOW	Os dados apontados pelo parâmetro de saída não cabem no tipo de destino.
DISP_E_TYPEMISMATCH	O argumento não pôde ser forçado para o tipo especificado.
E_INVALIDARG	Um argumento é inválido.
E_OUTOFMEMORY	Não foi possível alocar memória para a conversão.

Remarks

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

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
VariantChangeType
VariantChangeTypeEx

Concepts

Determining Supported COM APIs