NetGetAadJoinInformation-Funktion (lmjoin.h)

  • Artikel

Ruft die Joininformationen für den angegebenen Mandanten ab. Diese Funktion untersucht die Joininformationen für Microsoft Azure Active Directory und das Geschäftskonto, das der aktuelle Benutzer hinzugefügt hat.

Syntax

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

Parameter

[in, optional] pcszTenantId

Der Mandantenbezeichner für das verknüpfte Konto. Wenn das Gerät nicht mit Azure Active Directory (Azure AD) verknüpft ist und der derzeit bei Windows angemeldete Benutzer keine Azure AD-Arbeitskonten für den angegebenen Mandanten hinzugefügt hat, wird der Puffer, auf den der ppJoinInfo-Parameter verweist, auf NULL festgelegt.

Wenn die angegebene Mandanten-ID NULL oder leer ist, wird ppJoinInfo auf die Standardbeitrittskontoinformationen oder AUF NULL festgelegt, wenn das Gerät nicht mit Azure AD verknüpft ist und der aktuelle Benutzer keine Azure AD-Arbeitskonten hinzugefügt hat.

Das Standardbeitrittskonto ist eines der folgenden:

  • Das Azure AD-Konto, wenn das Gerät mit Azure AD verknüpft ist.
  • Das Azure AD-Arbeitskonto, das der aktuelle Benutzer hinzugefügt hat, wenn das Gerät nicht mit Azure AD verknüpft ist, der aktuelle Benutzer jedoch ein einzelnes Azure AD-Arbeitskonto hinzugefügt hat.
  • Eines der Azure AD-Arbeitskonten, die der aktuelle Benutzer hinzugefügt hat, wenn das Gerät nicht in Azure AD eingebunden ist, der aktuelle Benutzer jedoch mehrere Azure AD-Arbeitskonten hinzugefügt hat. Der Algorithmus zum Auswählen eines der Arbeitskonten ist nicht angegeben.

[out] ppJoinInfo

Die Joininformationen für den Mandanten, den der parameter pcszTenantId angibt. Wenn dieser Parameter NULL ist, ist das Gerät nicht mit Azure AD verknüpft, und der aktuelle Benutzer hat keine Azure AD-Arbeitskonten hinzugefügt. Sie müssen die NetFreeAadJoinInformation-Funktion aufrufen, um den für diese Struktur zugewiesenen Arbeitsspeicher freizugeben.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile lmjoin.h
Bibliothek Netapi32.lib
DLL Netapi32.dll

Weitere Informationen

NetFreeAadJoinInformation