IWiaDrvItem ::GetItemName, méthode (wiamindr_lh.h)
La méthode IWiaDrvItem ::GetItemName obtient l'IWiaDrvItem nom d’élément actuel, sans inclure les informations de chemin d’accès.
Syntaxe
HRESULT GetItemName(
BSTR *__MIDL__IWiaDrvItem0003
);
Paramètres
__MIDL__IWiaDrvItem0003
pbstrItemName [out, optional]
Pointe vers un emplacement de mémoire qui recevra l’adresse de la chaîne contenant le nom de l’élément.
Valeur de retour
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
S’il y a suffisamment de mémoire disponible, 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |