NetGetAadJoinInformation, fonction (lmjoin.h)

  • Article

Récupère les informations de jointure pour le locataire spécifié. Cette fonction examine les informations de jointure pour Microsoft Azure Active Directory et le compte professionnel que l’utilisateur actuel a ajouté.

Syntaxe

HRESULT NET_API_FUNCTION NetGetAadJoinInformation(
  [in, optional] LPCWSTR          pcszTenantId,
  [out]          PDSREG_JOIN_INFO *ppJoinInfo
);

Paramètres

[in, optional] pcszTenantId

Identificateur de locataire pour le compte joint. Si l’appareil n’est pas joint à Azure Active Directory (Azure AD) et que l’utilisateur actuellement connecté à Windows n’a ajouté aucun compte de travail Azure AD pour le locataire spécifié, la mémoire tampon vers laquelle pointe le paramètre ppJoinInfo est définie sur NULL.

Si l’ID de locataire spécifié est NULL ou vide, ppJoinInfo est défini sur les informations de compte de jointure par défaut, ou NULL si l’appareil n’est pas joint à Azure AD et que l’utilisateur actuel n’a ajouté aucun compte professionnel Azure AD.

Le compte de jointure par défaut est l’un des éléments suivants :

  • Le compte Azure AD, si l’appareil est joint à Azure AD.
  • Compte professionnel Azure AD que l’utilisateur actuel a ajouté, si l’appareil n’est pas joint à Azure AD, mais que l’utilisateur actuel a ajouté un seul compte professionnel Azure AD.
  • Tous les comptes de travail Azure AD que l’utilisateur actuel a ajoutés, si l’appareil n’est pas joint à Azure AD, mais que l’utilisateur actuel a ajouté plusieurs comptes professionnels Azure AD. L’algorithme de sélection de l’un des comptes professionnels n’est pas spécifié.

[out] ppJoinInfo

Informations de jointure pour le locataire que le paramètre pcszTenantId spécifie. Si ce paramètre a la valeur NULL, l’appareil n’est pas joint à Azure AD et l’utilisateur actuel n’a ajouté aucun compte professionnel Azure AD. Vous devez appeler la fonction NetFreeAadJoinInformation pour libérer la mémoire allouée pour cette structure.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête lmjoin.h
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

NetFreeAadJoinInformation