Compartilhar via


Função PropVariantToWinRTPropertyValue (propsys.h)

Extrai dados de uma estrutura PROPVARIANT em um valor de propriedade Windows Runtime. Observe que, em alguns casos, mais de um tipo PROPVARIANT é mapeado para um único tipo de propriedade Windows Runtime.

Sintaxe

PSSTDAPI PropVariantToWinRTPropertyValue(
  [in]  REFPROPVARIANT propvar,
  [in]  REFIID         riid,
  [out] void           **ppv
);

Parâmetros

[in] propvar

Referência a uma estrutura PROPVARIANT de origem .

[in] riid

Uma referência à IID da interface a ser recuperada por meio de ppv, normalmente IID_IPropertyValue (definida em Windows.Foundation.h).

[out] ppv

Quando esse método retorna com êxito, contém o ponteiro de interface solicitado em riid. Normalmente, esse é um ponteiro IPropertyValue . Se a chamada falhar, esse valor será NULL.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Recomendamos que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação no riid que pode levar a resultados inesperados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho propsys.h (inclua Windows.Foundation.h)
Biblioteca Propsys.lib
DLL Propsys.dll

Confira também

Classe PropertyValue