Funzione InitPropVariantFromResource (propvarutil.h)
Inizializza una struttura PROPVARIANT basata su una risorsa stringa incorporata in un file eseguibile.
Sintassi
PSSTDAPI InitPropVariantFromResource(
[in] HINSTANCE hinst,
[in] UINT id,
[out] PROPVARIANT *ppropvar
);
Parametri
[in] hinst
Tipo: HINSTANCE
Handle in un'istanza del modulo il cui file eseguibile contiene la risorsa stringa.
[in] id
Tipo: UINT
Identificatore intero della stringa da caricare.
[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
Questa funzione crea un VT_LPWSTR propvariante. Se la risorsa specificata non esiste, inizializza PROPVARIANT con una stringa vuota. Le stringhe di risorsa più lunghe di 1024 caratteri vengono troncate e terminate con null.
Esempio
Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare InitPropVariantFromResource.
// HINSTANCE hinst;
// UINT id;
// Assume variables hinst and id are initialized and valid.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromResource(hinst, id, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_LPWSTR.
PropVariantClear(&propvar);
}
Requisiti
| 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 |