Fonction PropVariantToInt64WithDefault (propvarutil.h)
Extrait la valeur de la propriété Int64 d’une structure PROPVARIANT . Si aucune valeur n’existe, la valeur par défaut spécifiée est retournée.
Syntaxe
PSSTDAPI_(LONGLONG) PropVariantToInt64WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] LONGLONG llDefault
);
Paramètres
[in] propvarIn
Type : REFPROPVARIANT
Référence à une structure PROPVARIANT source.
[in] llDefault
Type : LONGLONG
Spécifie une valeur de propriété par défaut, à utiliser lorsqu’aucune valeur n’existe actuellement.
Valeur retournée
Type : LONGLONG
Retourne la valeur LONGLONG extraite ou la valeur par défaut.
Notes
Cette fonction d’assistance est utilisée dans les endroits où l’application appelante s’attend à ce qu’un PROPVARIANT contienne une valeur LONGLONG et souhaite utiliser une valeur par défaut si ce n’est pas le cas. Par instance, une application qui obtient des valeurs à partir d’un magasin de propriétés peut l’utiliser pour extraire en toute sécurité la valeur LONGLONG des propriétés Int64.
Si la propriété PROPVARIANT source a le type VT_I8, cette fonction d’assistance extrait la valeur LONGLONG . Sinon, il tente de convertir la valeur de la structure PROPVARIANT en longlong. Si le PROPVARIANT source a le type VT_EMPTY ou si une conversion n’est pas possible, PropVariantToInt64WithDefault retourne la valeur par défaut fournie par llDefault. Pour obtenir la liste des conversions possibles, consultez PropVariantChangeType .
Exemples
L’exemple suivant, à inclure dans un programme plus grand, montre comment utiliser PropVariantToInt64WithDefault pour accéder à une valeur LONGLONG dans un PROPVARIANT.
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
// The application is expecting propvar to hold a VT_I8 value, but wishes to treat VT_EMPTY as -1.
LONGLONG llValue = PropVariantToInt64WithDefault(propvar, -1);
// llValue is valid
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 |
Voir aussi
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