IWiaDrvItem ::GetFullItemName, méthode (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, optional]
Pointe vers un emplacement de mémoire qui recevra l’adresse d’une chaîne contenant le nom complet de l’élément.
Valeur de retour
Si la méthode réussit, elle stocke un pointeur vers le nom complet de l’élément, y compris les informations de chemin d’accès, 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
S’il y a suffisamment de mémoire disponible, cette méthode alloue une chaîne contenant le nom complet de l’élément actuel, 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 lors de la création de l’élément par la fonction de bibliothèque de services de pilotes wiasCreateDrvItem.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |