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	RuntimeObject.lib

Consulte también

CoInitializeEx

RO_INIT_TYPE

RoUninitialize