Funzione InitVariantFromDispatch (propvarutil.h)

Articolo
03/01/2024

Inizializza una struttura VARIANT basata su un'istanza di un oggetto IDispatch .

Sintassi

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

Parametri

[in] pdisp

Tipo: IDispatch*

Puntatore all'IDispatch di origine.

[out] pvar

Tipo: VARIANT*

Quando termina, questa funzione contiene la struttura VARIANT inizializzata.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Crea una variante VT_DISPATCH .

Si tratta di una funzione inline, con il codice sorgente fornito nell'intestazione. Non è incluso in alcun file .dll o lib.

Esempio

Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare 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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propvarutil.h
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Condividi tramite