Método INodeProperties::GetProperty (mmc.h)

Artigo
08/24/2023

O método GetProperty recupera valores de propriedade somente texto para um nó. Sua implementação do método INodeProperties::GetProperty é chamada quando um aplicativo baseado no Modelo de Objeto de Automação do MMC 2.0 recupera a propriedade Node.Property .

Sintaxe

HRESULT GetProperty(
  [in]  LPDATAOBJECT pDataObject,
  [in]  BSTR         szPropertyName,
  [out] PBSTR        pbstrProperty
);

Parâmetros

[in] pDataObject

Um ponteiro para o objeto de dados snap-in.

[in] szPropertyName

O nome da propriedade recuperada.

[out] pbstrProperty

Valor de texto para a propriedade .

Valor retornado

O snap-in retornará S_OK se fornecer o valor da propriedade quando esse método for chamado. Se o snap-in retornar S_FALSE, o objeto de dados será consultado quanto ao valor da propriedade.

Comentários

A extensão Modo de Exibição Estendida usa duas propriedades: CCF_DESCRIPTION e CCF_HTML_DETAILS. Como alternativa ao fornecimento de valores para essas propriedades usando o objeto de dados para consultar os formatos de área de transferência CCF_DESCRIPTION e CCF_HTML_DETAILS , um snap-in pode usar INodeProperties::GetProperty para retornar os valores de propriedade para o Modo de Exibição Estendido. Essa alternativa é benéfica em situações em que o objeto de dados de um snap-in não fornece as informações desejadas.

Além de fornecer valores de propriedade CCF_DESCRIPTION e CCF_HTML_DETAILS, um snap-in pode usar INodeProperties para fornecer valores para outras propriedades baseadas em texto (por exemplo, com uma nova extensão de exibição).

Para obter mais informações e um exemplo de código para INodeProperties::GetProperty, consulte Usando a extensão de exibição estendida – Detalhes da implementação.