OleRegGetMiscStatus, fonction (ole2.h)

Retourne diverses informations sur la présentation et les comportements pris en charge par le CLSID spécifié à partir du Registre.

Cette fonction est utilisée par les développeurs d’applications objet DLL personnalisées pour émuler le comportement du gestionnaire OLE par défaut.

Syntaxe

HRESULT OleRegGetMiscStatus(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwAspect,
  [out] DWORD    *pdwStatus
);

Paramètres

[in] clsid

CLSID de la classe pour laquelle status informations doivent être demandées.

[in] dwAspect

Aspect de présentation de la classe pour laquelle des informations sont demandées. Les valeurs possibles sont extraites de l’énumération DVASPECT .

[out] pdwStatus

Pointeur vers la variable qui reçoit les informations status.

Valeur retournée

Cette fonction peut retourner la valeur de retour standard E_OUTOFMEMORY, ainsi que les valeurs suivantes.

Notes

Les applications objet peuvent demander à OLE d’obtenir diverses informations status de deux façons. Une méthode consiste à appeler OleRegGetMiscStatus. L’autre consiste à retourner OLE_S_USEREG en réponse aux appels du gestionnaire d’objets par défaut à IOleObject::GetMiscStatus. OLE_S_USEREG indique au gestionnaire par défaut d’appeler OleRegGetMiscStatus. Étant donné que les applications d’objet DLL ne peuvent pas retourner OLE_S_USEREG, elles doivent appeler OleRegGetMiscStatus au lieu de déléguer le travail au gestionnaire d’objets.

OleRegGetMiscStatus et ses fonctions frères, OleRegGetUserType, OleRegEnumFormatEtc et OleRegEnumVerbs, permettent aux développeurs d’applications d’objets DLL personnalisées d’émuler le comportement du gestionnaire d’objets par défaut d’OLE pour obtenir des informations sur les objets à partir du Registre. En utilisant ces fonctions, vous évitez le travail considérable d’écriture des vôtres et les pièges inhérents au travail directement dans le registre. En outre, vous bénéficiez d’améliorations et d’optimisations futures de ces fonctions sans avoir à les coder vous-même.

Spécifications

Voir aussi

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType