OleRegGetUserType, fonction (ole2.h)

Article
03/04/2024

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.

Code de retour	Description
S_OK	Le type d’utilisateur a été retourné avec succès.
REGDB_E_CLASSNOTREG	Aucun CLSID n’est inscrit pour l’objet de classe.
REGDB_E_READREGDB	Une erreur s’est produite dans le Registre.
OLE_E_REGDB_KEY	Les clés ProgID = MainUserTypeName et CLSID = MainUserTypeName sont manquantes dans le Registre.

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

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ole2.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll
Ensemble d’API	ext-ms-win-com-ole32-l1-1-3 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

IOleObject ::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus

Partager via