Função CoGetApartmentType (combaseapi.h)
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 |
|---|---|
|
A chamada não pôde consultar com êxito o tipo de apartamento atual e o qualificador de tipo. |
|
Um valor de parâmetro inválido foi fornecido à função . Especificamente, um ou ambos os parâmetros foram definidos como NULL pelo chamador. |
|
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:
- Chame CoGetContextToken para obter o token de contexto atual.
- Converta o token de contexto em um ponteiro IUnknown*.
- Chame o método QueryInterface nesse ponteiro para obter a interface IComThreadingInfo .
- Chame o método GetCurrentApartmentType da interface IComThreadingInfo para obter o tipo de apartamento atual.
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 |