Método IPersist::GetClassID (objidl.h)

Artículo
08/25/2023

Recupera el identificador de clase (CLSID) del objeto .

Sintaxis

HRESULT GetClassID(
  [out] CLSID *pClassID
);

Parámetros

[out] pClassID

Puntero a la ubicación que recibe el CLSID al devolver. CLSID es un identificador único global (GUID) que representa de forma única una clase de objeto que define el código que puede manipular los datos del objeto.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, es E_FAIL.

Comentarios

El método GetClassID recupera el identificador de clase (CLSID) de un objeto, que se usa en operaciones posteriores para cargar código específico del objeto en el contexto del autor de la llamada.

Notas a los autores de llamadas

Una aplicación contenedora podría llamar a este método para recuperar el CLSID original de un objeto que trata como una clase diferente. Esta llamada sería necesaria si un usuario realizó una operación de edición que requería guardar el objeto. Si el contenedor fuera a guardarlo con el CLSID treat-as, la aplicación original ya no podría editar el objeto. Normalmente, en este caso, el contenedor llama a la función auxiliar OleSave , que realiza todos los pasos necesarios. Por este motivo, la mayoría de las aplicaciones contenedora no necesitan llamar directamente a este método.

La excepción sería un contenedor que proporciona un controlador de objetos para determinados objetos. En concreto, una aplicación contenedora no debe obtener el CLSID de un objeto y, a continuación, usarlo para recuperar información específica de la clase del registro. En su lugar, el contenedor debe usar interfaces IOleObject e IDataObject para recuperar dicha información específica de la clase directamente del objeto.

Notas para los implementadores

Normalmente, las implementaciones de este método simplemente proporcionan un CLSID constante para un objeto. Sin embargo, si la aplicación que admite la emulación ha establecido la clave del Registro TreatAs del objeto (y, por tanto, trata el objeto como una de una clase diferente), una llamada a GetClassID debe proporcionar el CLSID especificado en la clave TreatAs . Para obtener más información sobre la emulación, vea CoTreatAsClass.

Cuando un objeto está en estado de ejecución, el controlador predeterminado llama a una implementación de GetClassID que delega la llamada a la implementación en el objeto . Cuando el objeto no se está ejecutando, el controlador predeterminado llama a la función ReadClassStg para leer el CLSID que se guarda en el almacenamiento del objeto.

Si va a escribir un controlador de objetos personalizado para el objeto, es posible que desee simplemente delegar este método en la implementación del controlador predeterminado (consulte OleCreateDefaultHandler).

Notas del moniker de dirección URL

Este método devuelve CLSID_StdURLMoniker.

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	objidl.h