Metodo IWiaDrvItem::GetItemName (wiamindr_lh.h)
Il metodo IWiaDrvItem::GetItemName ottiene il nome dell'elemento IWiaDrvItem corrente, non incluse le informazioni sul percorso.
Sintassi
HRESULT GetItemName(
BSTR *__MIDL__IWiaDrvItem0003
);
Parametri
__MIDL__IWiaDrvItem0003
pbstrItemName [out, facoltativo]
Punta a una posizione di memoria che riceverà l'indirizzo della stringa contenente il nome dell'elemento.
Valore restituito
Se il metodo ha esito positivo, archivia un puntatore al nome dell'elemento (le informazioni sul percorso non sono incluse) in pbstrItemName e restituisce S_OK. Se il metodo non riesce a allocare la stringa a causa di memoria insufficiente, restituisce E_OUTOFMEMORY. Se il parametro pbstrItemName 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, il metodo alloca una stringa contenente il nome dell'elemento corrente, escludendo le informazioni sul percorso. Il metodo restituisce un puntatore alla stringa in pbstrItemName. Il minidriver deve deallocare la memoria usata dalla stringa chiamando la funzione SysFreeString .
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamindr_lh.h (includere Wiamindr.h) |