Funzione InitPropVariantFromStrRet (propvarutil.h)
Inizializza una struttura PROPVARIANT basata su una stringa archiviata in una struttura STRRET .
Sintassi
PSSTDAPI InitPropVariantFromStrRet(
[in, out] STRRET *pstrret,
[in] PCUITEMID_CHILD pidl,
[out] PROPVARIANT *ppropvar
);
Parametri
[in, out] pstrret
Tipo: STRRET*
Puntatore a una struttura STRRET contenente la stringa.
[in] pidl
Tipo: PCUITEMID_CHILD
PIDL dell'elemento i cui dettagli vengono recuperati.
[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 propvariante.
Nota Questa funzione libera la memoria usata per il contenuto STRRET .
Esempio
L'esempio seguente, da includere come parte di un programma più grande, illustra come usare InitPropVariantFromStrRet.
// STRRET strret;
// PCUITEMID_CHILD pidl;
// Assume variables strret and pidl are initialized and valid.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromStrRet(strret, pidl, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_LPWSTR.
PropVariantClear(&propvar);
// Any allocated memory associated with strret has been freed.
}
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 |