共用方式為

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
標頭 lmjoin.h (包含 Lm.h)
程式庫 Netapi32.lib
Dll Netapi32.dll;Wkscli.dll

另請參閱

NetGetJoinableOUs

網路管理功能

網路管理概觀