Share via


Método IWiaDrvItem::GetItemName (wiamindr_lh.h)

O método IWiaDrvItem::GetItemName obtém o nome do item IWiaDrvItem atual, sem incluir informações de caminho.

Sintaxe

HRESULT GetItemName(
  BSTR *__MIDL__IWiaDrvItem0003
);

Parâmetros

__MIDL__IWiaDrvItem0003

pbstrItemName [out, opcional]

Aponta para um local de memória que receberá o endereço da cadeia de caracteres que contém o nome do item.

Retornar valor

Se o método for bem-sucedido, ele armazenará um ponteiro para o nome do item (as informações de caminho não estão incluídas) em pbstrItemName 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 pbstrItemName 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, o método alocará uma cadeia de caracteres que contém o nome do item atual, excluindo informações de caminho. O método retorna um ponteiro para a cadeia de caracteres em pbstrItemName. O minidriver deve desalocar a memória usada pela cadeia de caracteres chamando a função SysFreeString .

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wiamindr_lh.h (inclua Wiamindr.h)

Confira também

IWiaDrvItem

IWiaDrvItem::GetFullItemName