Compartilhar via


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

Confira também

NetFreeAadJoinInformation