Método IWiaDrvItem::GetFullItemName (wiamindr_lh.h)
El método IWiaDrvItem::GetFullItemName obtiene el nombre completo del elemento, incluida la información de ruta de acceso.
Sintaxis
HRESULT GetFullItemName(
BSTR *__MIDL__IWiaDrvItem0002
);
Parámetros
__MIDL__IWiaDrvItem0002
pbstrFullItemName [out, opcional]
Apunta a una ubicación de memoria que recibirá la dirección de una cadena que contiene el nombre completo del elemento.
Valor devuelto
Si el método se ejecuta correctamente, almacena un puntero al nombre completo del elemento, incluida la información de ruta de acceso, en pbstrFullItemName y devuelve S_OK. Si el método no puede asignar la cadena debido a una memoria insuficiente, devuelve E_OUTOFMEMORY. Si el parámetro pbstrFullItemName no es válido, el método devuelve E_INVALIDARG. Si se produce un error en el método por otro motivo, devuelve un código de error COM estándar.
Observaciones
Si hay suficiente memoria disponible, este método asigna una cadena que contiene el nombre completo del elemento actual, incluida la información de ruta de acceso. El método devuelve un puntero a la cadena de pbstrFullItemName. El minidriver debe desasignar la memoria usada por la cadena llamando a la función SysFreeString.
El nombre devuelto en pbstrFullItemName es el nombre asociado al elemento cuando la función de biblioteca de servicios de controladores creó por primera vez wiasCreateDrvItem.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wiamindr_lh.h (incluya Wiamindr.h) |