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

Artículo
08/24/2023

El método GetProperty recupera valores de propiedad de solo texto para un nodo. Se llama a la implementación del método INodeProperties::GetProperty cuando una aplicación basada en el modelo de objetos de Automatización MMC 2.0 recupera la propiedad Node.Property .

Sintaxis

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

Parámetros

[in] pDataObject

Puntero al objeto de datos del complemento.

[in] szPropertyName

Nombre de la propiedad recuperada.

[out] pbstrProperty

Valor de texto de la propiedad.

Valor devuelto

El complemento devuelve S_OK si proporciona el valor de propiedad cuando se llama a este método. Si el complemento devuelve S_FALSE, se consulta el objeto de datos para el valor de propiedad.

Comentarios

La extensión Vista extendida usa dos propiedades: CCF_DESCRIPTION y CCF_HTML_DETAILS. Como alternativa a proporcionar valores para estas propiedades mediante el objeto de datos para consultar el CCF_DESCRIPTION y CCF_HTML_DETAILS formatos del Portapapeles, un complemento puede usar INodeProperties::GetProperty para devolver los valores de propiedad a la vista extendida. Esta alternativa es beneficiosa en situaciones en las que el objeto de datos de un complemento no proporciona la información deseada.

Además de proporcionar CCF_DESCRIPTION y CCF_HTML_DETAILS valores de propiedad, un complemento puede usar INodeProperties para proporcionar valores para otras propiedades basadas en texto (por ejemplo, con una nueva extensión de vista).

Para obtener más información y un ejemplo de código para INodeProperties::GetProperty, vea Using the Extended View Extension - Implementation Details.