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

Vedi anche

IWiaDrvItem

wiasCreateDrvItem