Méthode IMFAttributes ::GetStringLength (mfobjects.h)

Article
02/28/2024

Récupère la longueur d’une valeur de chaîne associée à une clé.

Syntaxe

HRESULT GetStringLength(
  [in]  REFGUID guidKey,
  [out] UINT32  *pcchLength
);

Paramètres

[in] guidKey

GUID qui identifie la valeur à récupérer. Le type d’attribut doit être MF_ATTRIBUTE_STRING.

[out] pcchLength

Si la clé est trouvée et que la valeur est un type de chaîne, ce paramètre reçoit le nombre de caractères dans la chaîne, sans inclure le caractère NULL de fin. Pour obtenir la valeur de chaîne, appelez IMFAttributes ::GetString.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
MF_E_ATTRIBUTENOTFOUND	La clé spécifiée est introuvable.
MF_E_INVALIDTYPE	La valeur de l’attribut n’est pas une chaîne.

Remarques

Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Édition Media Center) installés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	mfobjects.h (inclure Mfidl.h)
Bibliothèque	Mfuuid.lib

Voir aussi

Attributs et propriétés

IMFAttributes

MF_ATTRIBUTE_TYPE

Partager via