função PSPropertyBag_ReadStr (propsys.h)
Lê o valor de dados de cadeia de caracteres de uma propriedade em um recipiente de propriedades.
Sintaxe
PSSTDAPI PSPropertyBag_ReadStr(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] LPWSTR value,
[out] int characterCount
);
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: LPCWSTR
Quando essa função retorna, contém um ponteiro para um valor de propriedade de cadeia de caracteres.
[out] characterCount
Tipo: int
Essa função retorna o inteiro que representa o tamanho (número máximo de caracteres) do parâmetro de valor que está sendo retornado.
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
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 |
| Biblioteca | Propsys.lib |
| DLL | Propsys.dll (versão 6.0 ou posterior) |