Compartir a través de


Función RoInitialize (roapi.h)

Inicializa Windows Runtime en el subproceso actual con el modelo de simultaneidad especificado.

Syntax

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

Parámetros

[in] initType

Tipo: RO_INIT_TYPE

Modelo de simultaneidad para el subproceso. El valor predeterminado es RO_INIT_MULTITHREADED.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes valores.

Código de retorno Description
S_OK
Windows Runtime se inicializó correctamente en este subproceso.
S_FALSE
Windows Runtime ya se ha inicializado en este subproceso.
RPC_E_CHANGED_MODE
Una llamada anterior a RoInitialize especificó el modelo de simultaneidad para este subproceso como un apartamento multiproceso (MTA). Esto también podría indicar que se ha producido un cambio de un apartamento de subproceso neutro a un solo subproceso.

Observaciones

Usa la función RoInitialize para inicializar un subproceso en Windows Runtime. Todos los subprocesos que activan e interactúan con objetos de Windows Runtime deben inicializarse antes de llamar a Windows Runtime.

Llame a la función RoUninitialize para cerrar Windows Runtime en el subproceso actual. Cada llamada correcta a RoInitialize, incluidas las que devuelven S_FALSE, debe equilibrarse mediante una llamada correspondiente a RoUninitialize.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
Header roapi.h
Library mincore.lib

Consulte también

CoInitializeEx

RO_INIT_TYPE

RoUninitialize