Función NetGetJoinableOUs (lmjoin.h)

La función NetGetJoinableOUs recupera una lista de unidades organizativas (UNIDADES organizativas) en las que se puede crear una cuenta de equipo.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetGetJoinableOUs(
  [in]  LPCWSTR lpServer,
  [in]  LPCWSTR lpDomain,
  [in]  LPCWSTR lpAccount,
  [in]  LPCWSTR lpPassword,
  [out] DWORD   *OUCount,
  [out] LPWSTR  **OUs
);

Parámetros

[in] lpServer

Puntero a una cadena constante que especifica el nombre DNS o NetBIOS del equipo en el que se va a llamar a la función. Si este parámetro es NULL, se usa el equipo local.

[in] lpDomain

Puntero a una cadena constante que especifica el nombre del dominio para el que se va a recuperar la lista de UNIDADES organizativas que se pueden unir.

[in] lpAccount

Puntero a una cadena constante que especifica el nombre de la cuenta que se va a usar al conectarse al controlador de dominio. La cadena debe especificar un nombre netBIOS de dominio y una cuenta de usuario (por ejemplo, "REDMOND\user") o el nombre principal de usuario (UPN) del usuario en forma de nombre de inicio de sesión de estilo Internet (por ejemplo, "someone@example.com"). Si este parámetro es NULL, se usa el contexto del autor de la llamada.

[in] lpPassword

Si el parámetro lpAccount especifica un nombre de cuenta, este parámetro debe apuntar a la contraseña que se usará al conectarse al controlador de dominio. De lo contrario, este parámetro debe ser NULL.

[out] OUCount

Recibe el recuento de UNIDADES organizativas devueltas en la lista de unidades organizativas que se pueden combinar.

[out] OUs

Puntero a una matriz que recibe la lista de unidades organizativas que se pueden combinar. El sistema asigna esta matriz y se debe liberar mediante una sola llamada a la función NetApiBufferFree . Para obtener más información, consulte Búferes de funciones de administración de red y longitudes de búfer de funciones de administración de red.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error o uno de los códigos de error del sistema.

Comentarios

No se requiere ninguna pertenencia especial a grupos para ejecutar correctamente la función NetGetJoinableOUs .

Para obtener más información sobre las unidades organizativas, consulte Administración de usuarios en la documentación de Active Directory.

Requisitos

Consulte también

NetGetJoinInformation

Funciones de administración de red

Introducción a la administración de redes