Método IWiaDrvItem::GetFullItemName (wiamindr_lh.h)
O método IWiaDrvItem::GetFullItemName obtém o nome completo do item, incluindo informações de caminho.
Sintaxe
HRESULT GetFullItemName(
BSTR *__MIDL__IWiaDrvItem0002
);
Parâmetros
__MIDL__IWiaDrvItem0002
pbstrFullItemName [out, opcional]
Aponta para um local de memória que receberá o endereço de uma cadeia de caracteres que contém o nome completo do item.
Retornar valor
Se o método for bem-sucedido, ele armazenará um ponteiro para o nome completo do item, incluindo informações de caminho, em pbstrFullItemName e retornará S_OK. Se o método não alocar a cadeia de caracteres devido à memória insuficiente, ele retornará E_OUTOFMEMORY. Se o parâmetro pbstrFullItemName for inválido, o método retornará E_INVALIDARG. Se o método falhar por outro motivo, ele retornará um código de erro COM padrão.
Comentários
Se houver memória suficiente disponível, esse método alocará uma cadeia de caracteres que contém o nome completo do item atual, incluindo informações de caminho. O método retorna um ponteiro para a cadeia de caracteres em pbstrFullItemName. O minidriver deve desalocar a memória usada pela cadeia de caracteres chamando a função SysFreeString .
O nome retornado em pbstrFullItemName é o nome associado ao item quando o item foi criado pela primeira vez pela função de biblioteca de serviços de driver wiasCreateDrvItem.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |