Fonction PropVariantToInt64 (propvarutil.h)
Extrait une valeur LONGLONG d’une structure PROPVARIANT . Si aucune valeur ne peut être extraite, une valeur par défaut est affectée.
Syntaxe
PSSTDAPI PropVariantToInt64(
[in] REFPROPVARIANT propvarIn,
[out] LONGLONG *pllRet
);
Paramètres
[in] propvarIn
Type : REFPROPVARIANT
Référence à une structure PROPVARIANT source.
[out] pllRet
Type : LONGLONG*
Lorsque cette fonction retourne, contient la valeur de la propriété extraite le cas échéant ; sinon, 0.
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 est utilisée dans les endroits où l’application appelante s’attend à ce qu’un PROPVARIANT contienne une valeur LONGLONG . 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 une conversion n’est pas possible, PropVariantToInt64 retourne un code d’échec et définit pllRet sur 0. Pour obtenir la liste des conversions possibles, consultez PropVariantChangeType . Notez que VT_EMPTY est correctement converti en 0.
Exemples
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
LONGLONG llValue; // The application is expecting propvar to hold a VT_I8 value
HRESULT hr = PropVariantToInt64(propvar, &llValue);
if (SUCCEEDED(hr))
{
// llValue is valid
}
else
{
// the extraction failed
}
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 |