Compartilhar via


Método IPerPropertyBrowsing::GetDisplayString (ocidl.h)

Recupera uma cadeia de caracteres de texto que descreve a propriedade especificada.

Sintaxe

HRESULT GetDisplayString(
  [in]  DISPID dispID,
  [out] BSTR   *pBstr
);

Parâmetros

[in] dispID

O identificador de expedição da propriedade cujo nome de exibição é solicitado.

[out] pBstr

Um ponteiro para uma variável que recebe o nome de exibição da propriedade identificada em dispID. A cadeia de caracteres é alocada por esse método usando SysAllocString. Após o retorno, a cadeia de caracteres é responsabilidade do chamador, que deve liberá-la com SysFreeString quando ela não for mais necessária.

Retornar valor

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
O nome de exibição foi retornado com êxito.
E_NOTIMPL
O objeto não fornece nomes de exibição para propriedades individuais. O chamador tem o recurso para marcar as informações de tipo do objeto para o nome do texto do objeto nesse caso.
E_POINTER
O endereço em pbstr não é válido. Por exemplo, pode ser NULL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

IPerPropertyBrowsing