WPRCCreateInstance

Descripción

Esta función crea una instancia de una clase especificada.

Sintaxis

HRESULT WPRCCreateInstance(
    _In_ REFCLSID rclsid,
    _In_opt_ LPUNKNOWN pUnkOuter,
    _In_ DWORD dwClsContext,
    _In_ REFIID riid,
    _Outptr_ LPVOID *ppv
);

Parámetros

rclsid

(En REFCLSID): El CLSID asociado con los datos y el código que se utilizarán para crear el objeto.

pUnkOuter

(En_opt LP DESCONOCIDO): Opcional. Si es NULO, el objeto no se está creando como parte de un agregado. Si no es NULO, apunte a la interfaz IUnknown del objeto agregado (la IUnknown controladora).

dwClsContext

(En DWORD): Contexto en el cual se ejecutará el código que administra el objeto recién creado. Los valores se toman de la clase de enumeración CLSCTX.

IDENTIFICACIÓN DE REFERENCIA riid

(En REFIID): Una referencia al identificador de la interfaz que se utilizará para comunicarse con el objeto.

ppv

(Outptr LPVOID): Dirección de la variable del puntero que recibe el puntero de la interfaz solicitado en riid. Al regresar exitosamente, *ppv contiene el puntero de la interfaz solicitado.

Valor devuelto

La función devuelve un código HRESULT. Una ejecución exitosa generalmente se indica con S_OK. El fallo se indica mediante cualquier otro código HRESULT, lo cual significa que se produjo un error durante la ejecución de la función.

Comentarios

Temas relacionados

Funciones