Freigeben über


InitPropVariantFromGUIDAsString-Funktion (propvarutil.h)

Initialisiert eine PROPVARIANT-Struktur basierend auf einer GUID. Die -Struktur wird als VT_LPWSTR initialisiert.

Syntax

PSSTDAPI InitPropVariantFromGUIDAsString(
  [in]  REFGUID     guid,
  [out] PROPVARIANT *ppropvar
);

Parameter

[in] guid

Typ: REFGUID

Verweis auf die Quell-GUID.

[out] ppropvar

Typ: PROPVARIANT*

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

Rückgabewert

Typ: HRESULT

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

Hinweise

Erstellt einen VT_LPWSTR PROPVARIANT, der die GUID in einem Format ähnlich formatiert {c200e360-38c5-11ce-ae62-08002b2b79ef}.

Beispiele

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

PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromGUIDAsString(FMTID_DocSummaryInformation, &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_LPWSTR.
 
    PropVariantClear(&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
Bibliothek Propsys.lib
DLL Propsys.dll (Version 6.0 oder höher)
Verteilbare Komponente Windows Desktop Search (WDS) 3.0

Weitere Informationen

InitPropVariantFromCLSID

InitPropVariantFromGUIDAsBuffer

InitVariantFromGUIDAsString

PropVariantToString