Função NetGetAadJoinInformation (lmjoin.h)
Recupera as informações de junção do locatário especificado. Essa função examina as informações de junção para Microsoft Azure Active Directory e a conta corporativa que o usuário atual adicionou.
Sintaxe
HRESULT NET_API_FUNCTION NetGetAadJoinInformation(
[in, optional] LPCWSTR pcszTenantId,
[out] PDSREG_JOIN_INFO *ppJoinInfo
);
Parâmetros
[in, optional] pcszTenantId
O identificador de locatário da conta ingressada. Se o dispositivo não estiver ingressado no Azure Active Directory (Azure AD) e o usuário atualmente conectado ao Windows não tiver adicionado nenhuma conta corporativa Azure AD para o locatário especificado, o buffer para o qual o parâmetro ppJoinInfo aponta será definido como NULL.
Se a ID de locatário especificada for NULL ou vazia, ppJoinInfo será definido como as informações de conta de junção padrão ou NULL se o dispositivo não estiver ingressado no Azure AD e o usuário atual não tiver adicionado nenhuma Azure AD contas corporativas.
A conta de ingresso padrão é uma das seguintes:
- A conta Azure AD, se o dispositivo estiver ingressado no Azure AD.
- O Azure AD conta corporativa que o usuário atual adicionou, se o dispositivo não estiver ingressado no Azure AD, mas o usuário atual adicionou uma única conta corporativa Azure AD.
- Qualquer uma das contas corporativas Azure AD que o usuário atual adicionou, se o dispositivo não estiver ingressado no Azure AD, mas o usuário atual adicionou várias contas corporativas Azure AD. O algoritmo para selecionar uma das contas corporativas não é especificado.
[out] ppJoinInfo
As informações de junção para o locatário que o parâmetro pcszTenantId especifica. Se esse parâmetro for NULL, o dispositivo não será ingressado no Azure AD e o usuário atual não adicionou nenhuma conta corporativa Azure AD. Você deve chamar a função NetFreeAadJoinInformation para liberar a memória alocada para essa estrutura.
Retornar valor
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | lmjoin.h |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |