Funzione InitPropVariantFromPropVariant (propvarutil.h)

Articolo
03/05/2024

Inizializza un elemento vettore in una struttura PROPVARIANT con un valore archiviato in un altro PROPVARIANT.

Sintassi

PSSTDAPI InitPropVariantVectorFromPropVariant(
  [in]  REFPROPVARIANT propvarSingle,
  [out] PROPVARIANT    *ppropvarVector
);

Parametri

[in] propvarSingle

Tipo: REFPROPVARIANT

Riferimento alla struttura PROPVARIANT di origine contenente un singolo valore.

[out] ppropvarVector

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

Questa funzione viene usata per convertire una struttura PROPVARIANT che contiene un singolo valore in un valore vettore.

Per i tipi di origine semplici, questa funzione inizializza il PROPVARIANT come vettore di un elemento.

Per un'origine contenente una stringa, questa funzione inizializza propVARIANT con zero o più sottostringa prese dalla stringa di origine, trattando i punti e virgola come delimitatori. Per altre informazioni, vedere InitPropVariantFromStringAsVector .

Sono supportati i tipi di input seguenti:

VT_I2
VT_UI2
VT_I4
VT_UI4
VT_I8
VT_UI8
VT_R8
VT_BOOL
VT_DATE
VT_FILETIME
VT_BSTR
VT_LPWSTR

I tipi aggiuntivi possono essere supportati in futuro.

Esempio

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

// PROPVARIANT propvarSource;
// Assume propvarSource is initialized and valid.

if (PropVariantGetElementCount(propvarSource) == 1)
{
    PROPVARIANT propvar;

    HRESULT hr = InitPropVariantVectorFromPropVariant(propvarSource, &propvar);

    if (SUCCEEDED(hr))
    {
       // propvar now is valid and is either VT_EMPTY or contains a vector.
       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

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount

Condividi tramite