Método IPropertyStore::GetValue (propsys.h)
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 |