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, optional]
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 realiza 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 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.
Comentarios
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 en 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 el elemento fue creado por primera vez por la función de biblioteca de servicios de controladores wiasCreateDrvItem.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | wiamindr_lh.h (incluya Wiamindr.h) |