INodeProperties::GetProperty, méthode (mmc.h)

Article
08/24/2023

La méthode GetProperty récupère les valeurs de propriété de texte uniquement pour un nœud. Votre implémentation de la méthode INodeProperties::GetProperty est appelée lorsqu’une application basée sur le modèle objet Automation MMC 2.0 récupère la propriété Node.Property .

Syntaxe

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

Paramètres

[in] pDataObject

Pointeur vers l’objet de données du composant logiciel enfichable.

[in] szPropertyName

Nom de la propriété récupérée.

[out] pbstrProperty

Valeur de texte de la propriété .

Valeur retournée

Le composant logiciel enfichable retourne S_OK s’il fournit la valeur de propriété lorsque cette méthode est appelée. Si le composant logiciel enfichable retourne S_FALSE, l’objet de données est interrogé pour la valeur de la propriété.

Notes

L’extension Vue étendue utilise deux propriétés : CCF_DESCRIPTION et CCF_HTML_DETAILS. Au lieu de fournir des valeurs pour ces propriétés à l’aide de l’objet de données pour interroger les formats CCF_DESCRIPTION et CCF_HTML_DETAILS presse-papiers, un composant logiciel enfichable peut utiliser INodeProperties::GetProperty pour renvoyer les valeurs de propriété à l’affichage étendu. Cette alternative est utile dans les situations où l’objet de données d’un composant logiciel enfichable ne fournit pas les informations souhaitées.

En plus de fournir des valeurs de propriété CCF_DESCRIPTION et CCF_HTML_DETAILS, un composant logiciel enfichable peut utiliser INodeProperties pour fournir des valeurs pour d’autres propriétés textuelles (par exemple, avec une nouvelle extension d’affichage).

Pour plus d’informations et un exemple de code pour INodeProperties::GetProperty, consultez Utilisation de l’extension d’affichage étendu - Détails de l’implémentation.