Fonction de rappel CLAIMMEDIALABEL (ntmsmli.h)

[Le Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La fonction de rappel ClaimMediaLabel détermine si une étiquette multimédia spécifiée a été créée par l’application associée du média.

Syntaxe

CLAIMMEDIALABEL Claimmedialabel;

DWORD Claimmedialabel(
  [in]  const BYTE * const pBuffer,
  [in]  const DWORD nBufferSize,
  [out] MediaLabelInfo * const pLabelInfo
)
{...}

Paramètres

[in] pBuffer

Pointeur vers une mémoire tampon qui contient l’étiquette de média.

[in] nBufferSize

Taille de la mémoire tampon, en octets.

[out] pLabelInfo

Pointeur vers une structure MediaLabelInfo . La bibliothèque d’étiquettes multimédias remplit cette structure si la bibliothèque reconnaît l’étiquette multimédia.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
NO_ERROR
Bibliothèque d’étiquettes multimédias renseignée dans la structure MediaLabelInfo .
ERROR_BAD_FORMAT
La bibliothèque d’étiquettes multimédias ne reconnaît pas l’étiquette multimédia.

Remarques

Lorsqu’une bibliothèque d’étiquettes multimédias utilise la fonction ClaimMediaLabel pour identifier l’étiquette multimédia comme une étiquette créée par son application associée, la bibliothèque d’étiquettes multimédias doit remplir la structure MediaLabelInfo et retourner NO_ERROR. Si la bibliothèque d’étiquettes multimédias ne reconnaît pas l’étiquette multimédia, elle retourne ERROR_BAD_FORMAT.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntmsmli.h

Voir aussi

Fonctions de bibliothèque d’étiquettes multimédias

MediaLabelInfo