Funzione InitPropVariantFromBuffer (propvarutil.h)

Articolo
03/15/2023

Inizializza una struttura PROPVARIANT utilizzando il contenuto di un buffer.

Sintassi

PSSTDAPI InitPropVariantFromBuffer(
  [in]  const void  *pv,
  [in]  UINT        cb,
  [out] PROPVARIANT *ppropvar
);

Parametri

[in] pv

Tipo: const void*

Puntatore al buffer.

[in] cb

Tipo: UINT

Lunghezza del buffer, in byte.

[out] ppropvar

Tipo: PROPVARIANT*

Quando termina, questa funzione 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_VECTOR | VT_UI1 propvariante.

Esempio

Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare InitPropVariantFromBuffer.

// void *pv;
// UINT cb;
// Assume variable pv and cb are initialized and valid. pv points to a buffer  
// and cb contains the size of the buffer in bytes.
PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromBuffer(pv, cb, &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_VECTOR | VT_UI1.
 
    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

Vedi anche

InitVariantFromBuffer

PropVariantToBuffer

Condividi tramite