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

Статья
03/14/2023

Функция 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	Недостаточно места для обработки этой команды.

Требования


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

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

NetGetJoinableOUs

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

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

Share via