Compartilhar via

Função CoGetApartmentType (combaseapi.h)

  • Artigo

Retorna o tipo de apartamento atual e o qualificador de tipo.

Sintaxe

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

Parâmetros

[out] pAptType

Valor de enumeração APTTYPE que especifica o tipo do apartment atual.

[out] pAptQualifier

Valor de enumeração APTTYPEQUALIFIER que especifica o qualificador de tipo do apartment atual.

Valor retornado

Retorna S_OK se a chamada tiver sido bem-sucedida. Caso contrário, um dos seguintes códigos de erro será retornado.

Código de retorno Descrição
E_FAIL
 A chamada não pôde consultar com êxito o tipo de apartamento atual e o qualificador de tipo.
E_INVALIDARG
 Um valor de parâmetro inválido foi fornecido à função . Especificamente, um ou ambos os parâmetros foram definidos como NULL pelo chamador.
CO_E_NOTINITIALIZED

CoInitialize ou CoInitializeEx não foi chamado nesse thread antes de chamar CoGetApartmentType.

Comentários

Em plataformas Windows anteriores ao Windows 7, as seguintes ações devem ser executadas em um thread para consultar o tipo de apartamento:

Em cenários multithread, há uma condição de corrida que pode potencialmente causar uma Violação de Acesso dentro do processo ao executar a sequência de operações acima. A função CoGetApartmentType é recomendada, pois ela não incorre potencialmente na Violação de Acesso.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho combaseapi.h (inclua Objbase.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

APTTYPE

APTTYPEQUALIFIER