Función CoGetApartmentType (combaseapi.h)

Devuelve el tipo de apartamento actual y el calificador de tipo.

Sintaxis

HRESULT CoGetApartmentType(
  [out] APTTYPE          *pAptType,
  [out] APTTYPEQUALIFIER *pAptQualifier
);

Parámetros

[out] pAptType

Valor de enumeración APTTYPE que especifica el tipo del apartamento actual.

[out] pAptQualifier

Valor de enumeración APTTYPEQUALIFIER que especifica el calificador de tipo del apartamento actual.

Valor devuelto

Devuelve S_OK si la llamada se realizó correctamente. De lo contrario, se devuelve uno de los siguientes códigos de error.

Comentarios

En las plataformas Windows anteriores a Windows 7, se deben realizar las siguientes acciones en un subproceso para consultar el tipo de apartamento:

• Llame a CoGetContextToken para obtener el token de contexto actual.
• Convierta el token de contexto en un puntero IUnknown*.
• Llame al método QueryInterface en ese puntero para obtener la interfaz IComThreadingInfo .
• Llame al método GetCurrentApartmentType de la interfaz IComThreadingInfo para obtener el tipo de apartamento actual.

En escenarios multiproceso, hay una condición de carrera que puede provocar una infracción de acceso dentro del proceso al ejecutar la secuencia de operaciones anterior. Se recomienda la función CoGetApartmentType , ya que no incurre en la infracción de acceso.

Requisitos

Consulte también

APTTYPE

APTTYPEQUALIFIER