função PSPropertyBag_WritePropertyKey (propsys.h)
Define o valor da chave de propriedade de uma propriedade em um recipiente de propriedades.
Sintaxe
PSSTDAPI PSPropertyBag_WritePropertyKey(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[in] REFPROPERTYKEY 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.
[in] value
Tipo: REFPROPERTYKEY
Uma estrutura PROPERTYKEY que especifica o valor da chave de propriedade a ser armazenada na propriedade .
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
As chaves de propriedade identificam exclusivamente uma propriedade. Por exemplo, PKEY_Keywords
corresponde à System.Keywords
. Essa função é bem-sucedida apenas para propriedades registradas como parte do esquema de propriedade.
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) |