InitVariantFromGUIDAsBuffer-Funktion (propvarutil.h)
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 |