InitVariantFromResource, fonction (propvarutil.h)
Initialise une structure VARIANT basée sur une ressource de chaîne incorporée dans un fichier exécutable.
Syntaxe
PSSTDAPI InitVariantFromResource(
[in] HINSTANCE hinst,
[in] UINT id,
[out] VARIANT *pvar
);
Paramètres
[in] hinst
Type : HINSTANCE
Gérez vers un instance du module dont le fichier exécutable contient la ressource de chaîne.
[in] id
Type : UINT
Identificateur entier de la chaîne à charger.
[out] pvar
Type : VARIANT*
Lorsque cette fonction est retournée, contient la structure VARIANT initialisée.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Crée une variante VT_BSTR. Si la ressource n’existe pas, cette fonction initialise le VARIANT en tant que VT_EMPTY et retourne un code d’échec.
Exemples
L’exemple suivant, à inclure dans le cadre d’un programme plus large, montre comment utiliser 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);
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP avec SP2, Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 avec SP1 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | propvarutil.h |
| Bibliothèque | Propsys.lib |
| DLL | Propsys.dll (version 6.0 ou ultérieure) |
| Composant redistribuable | Windows Desktop Search (WDS) 3.0 |