InitVariantFromGUIDAsBuffer-Funktion (propvarutil.h)

Artikel
08/25/2023

Initialisiert eine VARIANT-Struktur basierend auf einer GUID. Die Struktur wird als VT_ARRAY | VT_UI1.

Syntax

HRESULT InitVariantFromGUIDAsBuffer(
  [in]  REFGUID guid,
  [out] VARIANT *pvar
);

Parameter

[in] guid

Typ: REFGUID

Verweis auf die Quell-GUID.

[out] pvar

Typ: VARIANT*

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

Rückgabewert

Typ: HRESULT

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

Hinweise

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 InitVariantFromGUIDAsBuffer veranschaulicht.

VARIANT var;

HRESULT hr = InitVariantFromGUIDAsBuffer(FMTID_DocSummaryInformation, &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_ARRAY | VT_UI1.
    VariantClear(&var);
}

Anforderungen


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

Weitere Informationen

InitPropVariantFromCLSID

InitVariantFromGUIDAsString

VariantToBuffer

Freigeben über