Función OleRegGetUserType (ole2.h)

Obtiene el tipo de usuario de la clase especificada del Registro.

Los desarrolladores de aplicaciones de objetos DLL personalizadas usan esta función para emular el comportamiento del controlador predeterminado OLE.

Sintaxis

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

Parámetros

[in] clsid

CLSID de la clase para la que se va a solicitar el tipo de usuario.

[in] dwFormOfType

Forma de la cadena que se puede presentar por el usuario. Los valores posibles se toman de la enumeración USERCLASSTYPE.

[out] pszUserType

Puntero a una cadena que recibe el tipo de usuario.

Valor devuelto

Esta función puede devolver el valor devuelto estándar E_OUTOFMEMORY, así como los siguientes valores.

Comentarios

Las aplicaciones de objeto pueden pedir a OLE que obtenga el nombre de tipo de usuario de una clase especificada de dos maneras. Una manera es llamar a OleRegGetUserType. El otro consiste en devolver OLE_S_USEREG en respuesta a las llamadas del controlador de objetos predeterminado a IOleObject::GetUserType. OLE_S_USEREG indica al controlador predeterminado que llame a OleRegGetUserType. Dado que las aplicaciones de objetos DLL no pueden devolver OLE_S_USEREG, deben llamar a OleRegGetUserType, en lugar de delegar el trabajo en el controlador de objetos.

La función OleRegGetUserType y sus funciones del mismo nivel, OleRegGetMiscStatus, OleRegEnumFormatEtc y OleRegEnumVerbs, proporcionan una manera para que los desarrolladores de aplicaciones de objetos DLL personalizadas emulen el comportamiento del controlador de objetos predeterminado de OLE para obtener información sobre los objetos del Registro. Mediante el uso de estas funciones, se evita el trabajo considerable de escritura propia y los problemas inherentes a trabajar directamente en el registro. Además, obtendrá mejoras y optimizaciones futuras de estas funciones sin tener que codificarlas usted mismo.

Requisitos

Consulte también

IOleObject::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus