Share via

Función NetGetAadJoinInformation (lmjoin.h)

  • Artículo

Recupera la información de combinación del inquilino especificado. Esta función examina la información de combinación de Microsoft Azure Active Directory y la cuenta profesional que agregó el usuario actual.

Sintaxis

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

Parámetros

[in, optional] pcszTenantId

Identificador de inquilino de la cuenta unida. Si el dispositivo no está unido a Azure Active Directory (Azure AD) y el usuario que inició sesión actualmente en Windows no agregó ninguna cuenta de trabajo de Azure AD para el inquilino especificado, el búfer al que apunta el parámetro ppJoinInfo se establece en NULL.

Si el identificador de inquilino especificado es NULL o está vacío, ppJoinInfo se establece en la información de la cuenta de unión predeterminada o NULL si el dispositivo no está unido a Azure AD y el usuario actual no agregó ninguna cuenta profesional de Azure AD.

La cuenta de combinación predeterminada es una de las siguientes:

  • La cuenta de Azure AD, si el dispositivo está unido a Azure AD.
  • La cuenta profesional de Azure AD que agregó el usuario actual, si el dispositivo no está unido a Azure AD, pero el usuario actual agregó una sola cuenta profesional de Azure AD.
  • Cualquiera de las cuentas de trabajo de Azure AD que agregó el usuario actual, si el dispositivo no está unido a Azure AD, pero el usuario actual agregó varias cuentas de trabajo de Azure AD. No se especifica el algoritmo para seleccionar una de las cuentas de trabajo.

[out] ppJoinInfo

Información de combinación del inquilino que especifica el parámetro pcszTenantId . Si este parámetro es NULL, el dispositivo no está unido a Azure AD y el usuario actual no agregó ninguna cuenta profesional de Azure AD. Debe llamar a la función NetFreeAadJoinInformation para liberar la memoria asignada para esta estructura.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado lmjoin.h
Library Netapi32.lib
Archivo DLL Netapi32.dll

Consulte también

NetFreeAadJoinInformation