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
ERROR_NOT_ENOUGH_MEMORY	Não há armazenamento suficiente disponível para processar esse comando.
NERR_DefaultJoinRequired	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

Confira também

NetGetJoinInformation

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede