Función RoInitialize (roapi.h)

  • Artículo

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

Sintaxis

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 devuelto Descripción
S_OK
 El Windows Runtime se inicializó correctamente en este subproceso.
S_FALSE
 El 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 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.

Comentarios

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

Llame a la función RoUninitialize para cerrar el 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

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado roapi.h

Consulte también

CoInitializeEx

RO_INIT_TYPE

RoUninitialize