OleRegGetUserType, fonction (ole2.h)

Obtient le type d’utilisateur de la classe spécifiée à partir du Registre.

Les développeurs d’applications d’objets DLL personnalisées utilisent cette fonction pour émuler le comportement du gestionnaire OLE par défaut.

Syntaxe

HRESULT OleRegGetUserType(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwFormOfType,
  [out] LPOLESTR *pszUserType
);

Paramètres

[in] clsid

CLSID de la classe pour laquelle le type d’utilisateur doit être demandé.

[in] dwFormOfType

Forme de la chaîne présentable par l’utilisateur. Les valeurs possibles sont extraites de l’énumération USERCLASSTYPE.

[out] pszUserType

Pointeur vers une chaîne qui reçoit le type d’utilisateur.

Valeur retournée

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

Remarques

Les applications objet peuvent demander à OLE d’obtenir le nom de type d’utilisateur d’une classe spécifiée de deux manières. L’une des façons consiste à appeler OleRegGetUserType. L’autre consiste à retourner OLE_S_USEREG en réponse aux appels du gestionnaire d’objets par défaut à IOleObject ::GetUserType. OLE_S_USEREG indique au gestionnaire par défaut d’appeler OleRegGetUserType. Étant donné que les applications d’objet DLL ne peuvent pas retourner OLE_S_USEREG, elles doivent appeler OleRegGetUserType, plutôt que de déléguer le travail au gestionnaire d’objets.

La fonction OleRegGetUserType et ses fonctions frères, OleRegGetMiscStatus, OleRegEnumFormatEtc et OleRegEnumVerbs, permettent aux développeurs d’applications d’objet 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.

Configuration requise

Voir aussi

IOleObject ::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus