Compartilhar via


Função PSGetImageReferenceForValue (propsys.h)

Obtém uma instância de uma interface de descrição de propriedade para uma propriedade especificada.

Sintaxe

PSSTDAPI PSGetImageReferenceForValue(
  [in]  REFPROPERTYKEY propkey,
  [in]  REFPROPVARIANT propvar,
  [out] PWSTR          *ppszImageRes
);

Parâmetros

[in] propkey

Tipo: REFPROPERTYKEY

Uma referência a uma estrutura PROPERTYKEY que especifica a propriedade .

[in] propvar

Tipo: REFIID

Uma referência ao IID da interface a ser recuperada por meio de ppv.

[out] ppszImageRes

Tipo: void**

Quando essa função retorna com êxito, contém o ponteiro de interface solicitado em riid.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário, incluindo o seguinte:

Código de retorno Descrição
TYPE_E_ELEMENTNOTFOUND

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 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho propsys.h (inclua Propsys.idl)
Biblioteca Propsys.lib
DLL Propsys.dll (versão 6.0 ou posterior)