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

La méthode IWiaDrvItem ::GetFullItemName obtient le nom complet de l’élément, y compris les informations de chemin d’accès.

Syntaxe

HRESULT GetFullItemName(
  BSTR *__MIDL__IWiaDrvItem0002
);

Paramètres

__MIDL__IWiaDrvItem0002

pbstrFullItemName [out, facultatif]

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

Valeur retournée

Si la méthode réussit, elle stocke un pointeur vers le nom complet de l’élément, y compris les informations de chemin, dans pbstrFullItemName 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 pbstrFullItemName 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, cette méthode alloue une chaîne contenant le nom complet de l’élément actif, y compris les informations de chemin d’accès. La méthode retourne un pointeur vers la chaîne dans pbstrFullItemName. Le minidriver doit libérer la mémoire utilisée par la chaîne en appelant la fonction SysFreeString .

Le nom retourné dans pbstrFullItemName est le nom associé à l’élément lorsque l’élément a été créé pour la première fois par la fonction de bibliothèque de services de pilotes wiasCreateDrvItem.

Configuration requise

Voir aussi

IWiaDrvItem

wiasCreateDrvItem