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.
Código devuelto | Descripción |
---|---|
|
No hay suficiente almacenamiento disponible para procesar este comando. |
|
El controlador de dominio de destino no admite la creación de cuentas de equipo en unidades organizativas. |
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
Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | lmjoin.h (include Lm.h) |
Library | Netapi32.lib |
Archivo DLL | Netapi32.dll |