Metodo IWiaDrvItem::GetFullItemName (wiamindr_lh.h)
Il metodo IWiaDrvItem::GetFullItemName ottiene il nome completo dell'elemento, incluse le informazioni sul percorso.
Sintassi
HRESULT GetFullItemName(
BSTR *__MIDL__IWiaDrvItem0002
);
Parametri
__MIDL__IWiaDrvItem0002
pbstrFullItemName [out, facoltativo]
Punta a un percorso di memoria che riceverà l'indirizzo di una stringa contenente il nome completo dell'elemento.
Valore restituito
Se il metodo ha esito positivo, archivia un puntatore al nome completo dell'elemento, incluse le informazioni sul percorso, in pbstrFullItemName e restituisce S_OK. Se il metodo non riesce ad allocare la stringa a causa di memoria insufficiente, restituisce E_OUTOFMEMORY. Se il parametro pbstrFullItemName non è valido, il metodo restituisce E_INVALIDARG. Se il metodo ha esito negativo per un altro motivo, restituisce un codice di errore COM standard.
Commenti
Se è disponibile memoria sufficiente, questo metodo alloca una stringa contenente il nome completo dell'elemento corrente, incluse le informazioni sul percorso. Il metodo restituisce un puntatore alla stringa in pbstrFullItemName. Il minidriver deve deallocare la memoria usata dalla stringa chiamando la funzione SysFreeString .
Il nome restituito in pbstrFullItemName è il nome associato all'elemento quando l'elemento è stato creato per la prima volta dalla funzione della libreria dei servizi driver wiasCreateDrvItem.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamindr_lh.h (include Wiamindr.h) |