Compartilhar via

Função NetGetJoinInformation (lmjoin.h)

  • Artigo

A função NetGetJoinInformation recupera informações de junção status para o computador especificado.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetGetJoinInformation(
  [in]  LPCWSTR               lpServer,
  [out] LPWSTR                *lpNameBuffer,
  [out] PNETSETUP_JOIN_STATUS BufferType
);

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.

[out] lpNameBuffer

Ponteiro para o buffer que recebe o nome NetBIOS do domínio ou grupo de trabalho ao qual o computador está ingressado. Esse buffer é alocado pelo sistema e deve ser liberado usando 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.

[out] BufferType

Recebe o status de junção do computador especificado. Esse parâmetro pode ter um dos valores a seguir.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

Esses valores têm os seguintes significados.

Valor Significado
NetSetupUnknownStatus
 O status é desconhecido.
NetSetupUnjoined
 O computador não está ingressado.
NetSetupWorkgroupName
 O computador é ingressado em um grupo de trabalho.
NetSetupDomainName
 O computador é ingressado em um domínio.

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 o código 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.

Comentários

Nenhuma associação de grupo especial é necessária para executar com êxito a função NetGetJoinInformation .

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; Wkscli.dll

Confira também

NetGetJoinableOUs

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede