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.