Funzione InitPropVariantFromString (propvarutil.h)

Articolo
03/05/2024

Inizializza una struttura PROPVARIANT basata su una stringa specificata.

Sintassi

HRESULT InitPropVariantFromString(
  [in]  PCWSTR      psz,
  [out] PROPVARIANT *ppropvar
);

Parametri

[in] psz

Tipo: PCWSTR

Puntatore a un buffer contenente la stringa Unicode 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

Si tratta di una funzione inline, con il relativo codice sorgente fornito nell'intestazione. Non è incluso in alcun file .dll o lib.

Esempio

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

PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromString(L"Hello World", &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
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0