Méthode IWiaDrvItem ::GetItemName (wiamindr_lh.h)

La méthode IWiaDrvItem ::GetItemName obtient le nom de l’élément IWiaDrvItem actuel, sans inclure les informations de chemin d’accès.

Syntaxe

HRESULT GetItemName(
  BSTR *__MIDL__IWiaDrvItem0003
);

Paramètres

__MIDL__IWiaDrvItem0003

pbstrItemName [out, facultatif]

Pointe vers un emplacement de mémoire qui recevra l’adresse de la chaîne contenant le nom de l’élément.

Valeur retournée

Si la méthode réussit, elle stocke un pointeur vers le nom de l’élément (les informations de chemin d’accès ne sont pas incluses) dans pbstrItemName et retourne S_OK. Si la méthode ne parvient pas à allouer la chaîne en raison d’une mémoire insuffisante, elle retourne E_OUTOFMEMORY. Si le paramètre pbstrItemName n’est pas valide, la méthode retourne E_INVALIDARG. Si la méthode échoue pour une autre raison, elle retourne un code d’erreur COM standard.

Remarques

Si la mémoire disponible est suffisante, la méthode alloue une chaîne contenant le nom de l’élément actuel, à l’exclusion des informations de chemin d’accès. La méthode retourne un pointeur vers la chaîne dans pbstrItemName. Le minidriver doit libérer la mémoire utilisée par la chaîne en appelant la fonction SysFreeString .

Configuration requise

Voir aussi

IWiaDrvItem

IWiaDrvItem ::GetFullItemName