InitVariantFromDispatch-Funktion (propvarutil.h)

Artikel
03/06/2024

Initialisiert eine VARIANT-Struktur basierend auf einer instance eines IDispatch-Objekts.

Syntax

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

Parameter

[in] pdisp

Typ: IDispatch*

Zeiger auf den Quell-IDispatch.

[out] pvar

Typ: VARIANT*

Wenn diese Funktion zurückgibt, enthält die initialisierte VARIANT-Struktur .

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Erstellt eine VT_DISPATCH Variante.

Dies ist eine Inlinefunktion, deren Quellcode im Header bereitgestellt wird. Sie ist in keiner .dll- oder LIB-Datei enthalten.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von InitVariantFromDispatch veranschaulicht.

// 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);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propvarutil.h
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Freigeben über