Função NetGetJoinableOUs (lmjoin.h)
A função NetGetJoinableOUs recupera uma lista de UOs (unidades organizacionais) nas quais uma conta de computador pode ser criada.
Sintaxe
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
Ponteiro para uma cadeia de caracteres constante que especifica o nome DNS ou NetBIOS do computador no qual chamar a função. Se esse parâmetro for NULL, o computador local será usado.
[in] lpDomain
Ponteiro para uma cadeia de caracteres constante que especifica o nome do domínio para o qual recuperar a lista de UOs que podem ser unidas.
[in] lpAccount
Ponteiro para uma cadeia de caracteres constante que especifica o nome da conta a ser usado ao se conectar ao controlador de domínio. A cadeia de caracteres deve especificar um nome NetBIOS de domínio e uma conta de usuário (por exemplo, "REDMOND\user") ou o NOME UPN do usuário na forma de um nome de logon no estilo internet (por exemplo, "someone@example.com"). Se esse parâmetro for NULL, o contexto do chamador será usado.
[in] lpPassword
Se o parâmetro lpAccount especificar um nome de conta, esse parâmetro deverá apontar para a senha a ser usada ao se conectar ao controlador de domínio. Caso contrário, esse parâmetro deve ser NULL.
[out] OUCount
Recebe a contagem de UOs retornadas na lista de UOs ingressáveis.
[out] OUs
Ponteiro para uma matriz que recebe a lista de UOs ingressáveis. Essa matriz é alocada pelo sistema e deve ser liberada usando uma única chamada para a função NetApiBufferFree . Para obter mais informações, consulte Buffers de função de gerenciamento de rede e Comprimentos de buffer de função de gerenciamento de rede.
Valor retornado
Se a função for bem-sucedida, o valor retornado será NERR_Success.
Se a função falhar, o valor retornado poderá ser um dos códigos de erro a seguir ou um dos códigos de erro do sistema.
| Código de retorno | Descrição |
|---|---|
|
Não há armazenamento suficiente disponível para processar esse comando. |
|
O controlador de domínio de destino não dá suporte à criação de contas de computador em UOs. |
Comentários
Nenhuma associação de grupo especial é necessária para executar com êxito a função NetGetJoinableOUs .
Para obter mais informações sobre unidades organizacionais, consulte Gerenciando usuários na documentação do Active Directory.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | lmjoin.h (inclua Lm.h) |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |