Función Initialize (roapi.h)

  • Artículo

Inicializa un subproceso para usar Windows Runtime API.

Sintaxis

HRESULT Initialize(
  RO_INIT_TYPE initType
);

Parámetros

initType

Especifica el tipo de apartamento del subproceso que se va a inicializar.

Valor devuelto

  • S_OK : inicializado correctamente por primera vez en el subproceso actual
  • S_FALSE : inicialización anidada correcta (el subproceso actual ya se inicializó para el tipo de apartamento especificado)
  • E_INVALIDARG : valor initType no válido
  • CO_E_INIT_TLS : no se pudo asignar la estructura TLS interna de COM
  • E_OUTOFMEMORY : no se pudo asignar estructuras por subproceso o por apartamento que no sean TLS
  • RPC_E_CHANGED_MODE : el subproceso actual ya está inicializado para un tipo de apartamento diferente del especificado.

Comentarios

Windows::Foundation::Initialize se cambia para crear ASTAs en lugar de stAs clásicas para el valor de RO_INIT_TYPE RO_INIT_SINGLETHREADED. Windows::Foundation::Initialize(RO_INIT_SINGLETHREADED) no se admite para las aplicaciones de escritorio y devolverá CO_E_NOTSUPPORTED si se llama desde un proceso distinto de una aplicación de la Tienda Windows.

Para las aplicaciones de Microsoft DirectX, debe inicializar el subproceso inicial mediante Windows::Foundation::Initialize(RO_INIT_MULTITHREADED).

Para un servidor EXE fuera de proceso, debe inicializar el subproceso inicial del servidor mediante Windows::Foundation::Initialize(RO_INIT_MULTITHREADED).

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado roapi.h

Consulte también

RO_INIT_TYPE