Método IPropertyStore::GetValue (propsys.h)

  • Artigo

Esse método recupera os dados de uma propriedade específica.

Sintaxe

HRESULT GetValue(
  REFPROPERTYKEY key,
  PROPVARIANT    *pv
);

Parâmetros

key

TBD

pv

Depois que o IPropertyStore::GetValue método retorna com êxito, esse parâmetro aponta para uma estrutura PROPVARIANT que contém dados sobre a propriedade .

Retornar valor

Retorna S_OK ou INPLACE_S_TRUNCATED se tiver êxito ou um valor de erro de outra forma.

INPLACE_S_TRUNCATED é retornado para indicar que o PROPVARIANT retornado foi convertido em uma forma mais canônica. Por exemplo, isso seria feito para cortar espaços à esquerda ou à direita de um valor de cadeia de caracteres. Você deve usar a macro SUCCEEDED para marcar o valor retornado, que trata INPLACE_S_TRUNCATED como um código de êxito. A macro SUCCEEDED é definida no arquivo Winerror.h.

Comentários

Se PROPERTYKEY referenciado na chave não estiver presente no repositório de propriedades, esse método retornará S_OK e o membro vt da estrutura apontada por pv será definido como VT_EMPTY.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível com o Windows Vista e versões posteriores do sistema operacional Windows.
Plataforma de Destino Universal
Cabeçalho propsys.h
Biblioteca Propsys.idl
IRQL Todos os níveis

Confira também

Ipropertystore

IPropertyStore::GetAt