função PSPropertyBag_ReadUnknown (propsys.h)
Lê uma determinada propriedade de um valor de dados desconhecido em um recipiente de propriedades.
Sintaxe
PSSTDAPI PSPropertyBag_ReadUnknown(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[in] REFIID riid,
[out] void **ppv
);
Parâmetros
[in] propBag
Tipo: IPropertyBag*
Um ponteiro para um objeto IPropertyBag , que representa o recipiente de propriedades no qual a propriedade é armazenada.
[in] propName
Tipo: LPCWSTR
Um ponteiro para uma cadeia de caracteres de nome de propriedade terminada em nulo.
[in] riid
Tipo: REFIID
Uma referência ao IID da interface a ser recuperada por meio de ppv. Essa IID de interface deve ser IPropertyBag ou uma interface derivada de IPropertyBag.
[out] ppv
Tipo: void**
Quando esse método retorna com êxito, contém o ponteiro de interface solicitado em riid. Normalmente, isso é riid.
Retornar valor
Tipo: HRESULT
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
IPropertyBag e IPersistPropertyBag otimizam a funcionalidade Salvar como Texto. IPropertyBag e IPropertyBag2 fornecem um objeto com um recipiente de propriedades no qual o objeto pode salvar suas propriedades persistentemente. IPropertyBag2 permite que o objeto obtenha informações de tipo para cada propriedade: IPropertyBag2::Read faz com que uma ou mais propriedades sejam lidas do recipiente de propriedades e IPropertyBag2::Write faz com que uma ou mais propriedades sejam salvas no recipiente de propriedades.
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 |
| Biblioteca | Propsys.lib |
| DLL | Propsys.dll (versão 6.0 ou posterior) |