Función InitVariantFromResource (propvarutil.h)
Inicializa una estructura VARIANT basada en un recurso de cadena incrustado en un archivo ejecutable.
Sintaxis
PSSTDAPI InitVariantFromResource(
[in] HINSTANCE hinst,
[in] UINT id,
[out] VARIANT *pvar
);
Parámetros
[in] hinst
Tipo: HINSTANCE
Controle a una instancia del módulo cuyo archivo ejecutable contiene el recurso de cadena.
[in] id
Tipo: UINT
Identificador entero de la cadena que se va a cargar.
[out] pvar
Tipo: VARIANT*
Cuando esta función devuelve , contiene la estructura VARIANT inicializada.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Crea una variante VT_BSTR. Si el recurso no existe, esta función inicializa variant como VT_EMPTY y devuelve un código de error.
Ejemplos
En el ejemplo siguiente, que se va a incluir como parte de un programa mayor, se muestra cómo usar InitVariantFromResource.
// HINSTANCE hinst;
// UINT id;
// Assume variables hinst and id are initialized and valid.
VARIANT var;
HRESULT hr = InitVariantFromResource(hinst, id, &var);
if (SUCCEEDED(hr))
{
// var now is valid and has type VT_BSTR.
VariantClear(&var);
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propvarutil.h |
| Library | Propsys.lib |
| Archivo DLL | Propsys.dll (versión 6.0 o posterior) |
| Redistribuible | Búsqueda de escritorio de Windows (WDS) 3.0 |