função PSPropertyBag_ReadType (propsys.h)
Lê o tipo de valor de dados de uma propriedade armazenada em um recipiente de propriedades.
Sintaxe
PSSTDAPI PSPropertyBag_ReadType(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] VARIANT *var,
[out] VARTYPE type
);
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.
[out] var
Tipo: VARIANT*
Retorna após a conclusão bem-sucedida da função um ponteiro para um tipo de dados VARIANT que contém o valor da propriedade.
[out] type
Tipo: VARTYPE*
Se o tipo for VT_EMPTY, essa função lerá VARIANT da propriedade no parâmetro propBag IPropertyBag. Se o tipo não for VT_EMPTY e não o mesmo que a leitura VARIANT , essa função tentará converter a leitura VARIANT no PARÂMETRO VARTYPE definido pelo tipo antes de retornar.
Valor retornado
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
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) |