função PSPropertyBag_ReadLONG (propsys.h)
Lê um valor de dados LONG de uma propriedade em um recipiente de propriedades.
Sintaxe
PSSTDAPI PSPropertyBag_ReadLONG(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] LONG *value
);
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
Uma cadeia de caracteres de nome de propriedade terminada em nulo.
[out] value
Tipo: LONG*
Quando essa função retorna, contém um ponteiro para um valor de propriedade LONG .
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
Se o recipiente de propriedades ainda não contiver a propriedade especificada, a chamada ainda terá êxito.
A API da função de propriedade do recipiente de propriedades converte entre tipos de janela e o tipo VARIANT que é usado para expressar valores em um recipiente de propriedades. Isso facilita o uso do recipiente de propriedades, simplifica aplicativos e evita erros comuns de codificação.
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) |