PropVariantGetUInt16Elem, fonction (propvarutil.h)
Extrait un seul élément Int16 non signé d’une structure PROPVARIANT de type VT_U12, VT_VECTOR | VT_U12 ou VT_ARRAY | VT_U12.
Syntaxe
PSSTDAPI PropVariantGetUInt16Elem(
[in] REFPROPVARIANT propvar,
[in] ULONG iElem,
[out] USHORT *pnVal
);
Paramètres
[in] propvar
Type : REFPROPVARIANT
Référence à la structure PROPVARIANT source.
[in] iElem
Type : ULONG
L’index vectoriel ou matricielle ; sinon, iElem doit être 0.
[out] pnVal
Type : USHORT*
Lorsque cette fonction est retournée, contient la valeur de l’élément extrait.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Cette fonction d’assistance fonctionne pour les structures PROPVARIANT des types suivants :
- VT_UI2
- VT_VECTOR | VT_UI2
- VT_ARRAY | VT_UI2
Exemples
L’exemple suivant, à inclure dans le cadre d’un programme plus large, montre comment utiliser PropVariantGetUInt16Elem avec une instruction d’itération pour accéder aux valeurs d’un PROPVARIANT.
// PROPVARIANT propvar;
// Assume propvar is initialized and valid;
if ((propvar.vt & VT_TYPEMASK) == VT_UI2)
{
UINT cElem = PropVariantGetElementCount(propvar);
HRESULT hr = <mark type="const">S_OK</mark>;
for (UINT iElem = 0; SUCCEEDED(hr) && iElem < cElem; iElem ++)
{
USHORT nValue;
hr = PropVariantGetUInt16Elem(propvar, iElem, &nValue);
if (SUCCEEDED(hr))
{
// nValue is valid now
}
}
}
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 |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour