Compartilhar via

Função InitVariantFromDispatch (propvarutil.h)

  • Artigo

Inicializa uma estrutura VARIANT com base em uma instância de um objeto IDispatch .

Sintaxe

HRESULT InitVariantFromDispatch(
  [in]  IDispatch *pdisp,
  [out] VARIANT   *pvar
);

Parâmetros

[in] pdisp

Tipo: IDispatch*

Ponteiro para o IDispatch de origem.

[out] pvar

Tipo: VARIANT*

Quando essa função retorna, contém a estrutura VARIANT inicializada.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Cria uma variante VT_DISPATCH .

Essa é uma função embutida, com seu código-fonte fornecido no cabeçalho. Ele não está incluído em nenhum arquivo .dll ou .lib.

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar InitVariantFromDispatch.

// IDispatch *pDispatch;
// Assume variable pDispatch is initialized and valid.
VARIANT var;

HRESULT hr = InitVariantFromDispatch(pDispatch, &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_DISPATCH.
    VariantClear(&propvar);
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho propvarutil.h
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0