Função NetGetJoinInformation (lmjoin.h)

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 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.

Comentários

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

Requisitos

Confira também

NetGetJoinableOUs

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede