Fonction InitPropVariantFromResource (propvarutil.h)
Initialise une structure PROPVARIANT basée sur une ressource de chaîne incorporée dans un fichier exécutable.
Syntaxe
PSSTDAPI InitPropVariantFromResource(
[in] HINSTANCE hinst,
[in] UINT id,
[out] PROPVARIANT *ppropvar
);
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] ppropvar
Type : PROPVARIANT*
Lorsque cette fonction retourne, contient la structure PROPVARIANT initialisée.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Notes
Cette fonction crée un propvariant VT_LPWSTR. Si la ressource spécifiée n’existe pas, elle initialise propVARIANT avec une chaîne vide. Les chaînes de ressources de plus de 1 024 caractères sont tronquées et terminées par null.
Exemples
L’exemple suivant, à inclure dans un programme plus grand, montre comment utiliser 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);
}
Spécifications
| 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 |