Fonction InitPropVariantFromResource (propvarutil.h)

Article
08/25/2023

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