通过

NetGetJoinInformation 函数 (lmjoin.h)

  • 项目

NetGetJoinInformation 函数检索指定计算机的联接状态信息。

语法

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

parameters

[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
标头 lmjoin.h (包括 Lm.h)
Library Netapi32.lib
DLL Netapi32.dll;Wkscli.dll

另请参阅

NetGetJoinableOUs

网络管理功能

网络管理概述