Compartilhar via


Método IProgressItems::P rogressItemFromDescription (imapi2fs.h)

Recupera um item de progresso com base no nome de arquivo especificado.

Sintaxe

HRESULT ProgressItemFromDescription(
  [in]  BSTR          description,
  [out] IProgressItem **item
);

Parâmetros

[in] description

Cadeia de caracteres que contém o nome do arquivo do item de progresso a ser recuperado. O método retornará o item de progresso se essa cadeia de caracteres corresponder ao valor da propriedade de descrição do item.

[out] item

Uma interface IProgressItem do item de progresso associado ao nome do arquivo especificado.

Retornar valor

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
E_FAIL
description é NULL.

Value:0x80004005

E_POINTER
O ponteiro não é válido.

Valor: 0x80004003

E_OUTOFMEMORY
Falha ao alocar a memória necessária.

Valor: 0x8007000E

E_INVALIDARG
Um ou mais argumentos não são válidos.

Valor: 0x80070057

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imapi2fs.h

Confira também

IProgressItem

IProgressItems

IProgressItems::P rogressItemFromBlock

IProgressItems::get_Item