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) |