Funzione InitVariantFromString (propvarutil.h)
Inizializza una struttura VARIANT con una stringa.
Sintassi
HRESULT InitVariantFromString(
[in] PCWSTR psz,
[out] VARIANT *pvar
);
Parametri
[in] psz
Tipo: PCWSTR
Puntatore a un buffer contenente la stringa Unicode di origine. Se questo valore è NULL, la funzione inizializza VARIANT con un valore BSTRNULL.
[out] pvar
Tipo: VARIANT*
Quando questa funzione restituisce, contiene la struttura VARIANT 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 una variante VT_BSTR.
Si tratta di una funzione inline, con il relativo codice sorgente fornito nell'intestazione. Non è incluso in alcun file .dll o lib.
Esempio
Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare InitVariantFromString.
VARIANT var;
HRESULT hr = InitVariantFromString(L"This is a test", &var);
if (SUCCEEDED(hr))
{
// var now is valid and has type VT_BSTR.
VariantClear(&var);
}
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 |
| DLL | Propsys.dll (versione 6.0 o successiva) |
| Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |