Compartilhar via


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)

Confira também

PSPropertyBag_ReadPropertyKey