Поделиться через

Функция NetGetJoinInformation (lmjoin.h)

  • Статья

Функция NetGetJoinInformation извлекает сведения о состоянии соединения для указанного компьютера.

Синтаксис

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

Параметры

[in] lpServer

Указатель на константную строку, указывающую DNS или NetBIOS-имя компьютера, на котором будет вызываться функция. Если этот параметр имеет значение NULL, используется локальный компьютер.

[out] lpNameBuffer

Указатель на буфер, получающий NetBIOS-имя домена или рабочей группы, к которой присоединен компьютер. Этот буфер выделяется системой и должен быть освобожден с помощью функции NetApiBufferFree . Дополнительные сведения см. в разделах Буферы функций управления сетью и Длина буфера функции управления сетью.

[out] BufferType

Получает состояние соединения указанного компьютера. Этот параметр может иметь одно из следующих значений.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

Эти значения имеют следующие значения.

Значение Значение
NetSetupUnknownStatus
 Состояние неизвестно.
NetSetupUnjoined
 Компьютер не присоединен.
NetSetupWorkgroupName
 Компьютер присоединяется к рабочей группе.
NetSetupDomainName
 Компьютер присоединен к домену.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NERR_Success.

Если функция завершается ошибкой, возвращаемым значением может быть следующий код ошибки или один из кодов системных ошибок.

Код возврата Описание
ERROR_NOT_ENOUGH_MEMORY
 Недостаточно места для обработки этой команды.

Комментарии

Для успешного выполнения функции NetGetJoinInformation не требуется специальное членство в группе.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header lmjoin.h (включая Lm.h)
Библиотека Netapi32.lib
DLL Netapi32.dll; Wkscli.dll

См. также раздел

NetGetJoinableOUs

Функции управления сетью

Общие сведения об управлении сетью