WPRCCreateInstanceUnderInstanceName

Esta función crea una instancia de una clase especificada, con la opción de especificar el nombre de la instancia.

Sintaxis

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

Parámetros

bstrInstanceName

(En_opt BSTR): Opcional. Nombre de la instancia. Si este parámetro es NULO, la función crea una instancia sin nombre.

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.

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