Funzione InitPropVariantFromGUIDAsString (propvarutil.h)

Articolo
03/05/2024

Inizializza una struttura PROPVARIANT basata su un GUID. La struttura viene inizializzata come VT_LPWSTR.

Sintassi

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

Parametri

[in] guid

Tipo: REFGUID

Riferimento al GUID di origine.

[out] ppropvar

Tipo: PROPVARIANT*

Quando questa funzione restituisce, contiene la struttura PROPVARIANT 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 un VT_LPWSTR PROPVARIANT, che formatta il GUID in un formato simile a {c200e360-38c5-11ce-ae62-08002b2b79ef}.

Esempio

L'esempio seguente, da includere come parte di un programma più ampio, illustra come usare InitPropVariantFromGUIDAsString.

PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromGUIDAsString(FMTID_DocSummaryInformation, &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_LPWSTR.
 
    PropVariantClear(&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
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0