Compartir a través de

Función ProgIDFromCLSID (combaseapi.h)

  • Artículo

Recupera el ProgID de un CLSID determinado.

Sintaxis

HRESULT ProgIDFromCLSID(
  [in]  REFCLSID clsid,
  [out] LPOLESTR *lplpszProgID
);

Parámetros

[in] clsid

CLSID para el que se va a solicitar el ProgID.

[out] lplpszProgID

Dirección de una variable de puntero que recibe la cadena ProgID. La cadena que representa clsid incluye llaves envolventes.

Valor devuelto

Esta función puede devolver los valores siguientes.

Código devuelto Descripción
S_OK
 ProgID se devolvió correctamente.
REGDB_E_CLASSNOTREG
 Clase no registrada en el Registro.
REGDB_E_READREGDB
 Error al leer el registro.

Comentarios

Cada clase de objeto OLE que aparece en el cuadro de diálogo Insertar objeto debe tener un identificador de programación (ProgID), una cadena que identifica de forma única una clase determinada, almacenada en el Registro. Además de determinar la idoneidad del cuadro de diálogo Insertar objeto , el ProgID se puede usar como identificador en un lenguaje de programación de macros para identificar una clase. Por último, progID es también el nombre de clase utilizado para un objeto de una clase OLE que se coloca en un contenedor OLE 1.

ProgIDFromCLSID usa entradas en el Registro para realizar la conversión. Los autores de aplicaciones OLE son responsables de asegurarse de que el registro está configurado correctamente en el programa de instalación de la aplicación.

La cadena ProgID debe ser diferente del nombre de clase de cualquier aplicación OLE 1, incluida la versión OLE 1 de la misma aplicación, si existe. Además, una cadena ProgID no debe contener más de 39 caracteres, comenzar con un dígito o, excepto en un único punto, contener cualquier puntuación (incluidos los caracteres de subrayado).

El ProgID nunca debe mostrarse al usuario en la interfaz de usuario. Si necesita una cadena breve que se pueda mostrar para un objeto, llame a IOleObject::GetUserType.

Llame a la función CLSIDFromProgID para buscar el CLSID asociado a un ProgID determinado. Asegúrese de liberar el ProgID devuelto cuando haya terminado con él llamando a la función CoTaskMemFree .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado combaseapi.h (incluya Objbase.h)
Library Ole32.lib
Archivo DLL Ole32.dll

Consulte también

CLSIDFromProgID