NetEnumerateComputerNames 函式 (lmjoin.h)

發行項
08/24/2023

NetEnumerateComputerNames 函式會列舉指定電腦的名稱。

語法

NET_API_STATUS NET_API_FUNCTION NetEnumerateComputerNames(
  [in, optional] LPCWSTR                Server,
  [in]           NET_COMPUTER_NAME_TYPE NameType,
  [in]           ULONG                  Reserved,
  [out]          PDWORD                 EntryCount,
  [out]          LPWSTR                 **ComputerNames
);

參數

[in, optional] Server

常數位符串的指標，指定要在其中執行此函式的電腦名稱稱。如果此參數為 Null，則會使用本機電腦。

[in] NameType

查詢之名稱的類型。這個成員可以是下列其中一個值，這些值定義于Lmjoin.h標頭檔中定義的NET_COMPUTER_NAME_TYPE列舉中。

值	意義
NetPrimaryComputerName	主要電腦名稱稱。
NetAlternateComputerNames	替代電腦名稱稱。
NetAllComputerNames	所有電腦名稱稱。
NetComputerNameTypeMax	指出範圍結尾，指定要查詢之名稱類型的可能值。

[in] Reserved

保留供未來使用。此參數應該是 Null。

[out] EntryCount

DWORD 值的指標，如果函式成功，則會傳回 ComputerNames 參數所指向之緩衝區中傳回的名稱數目。

[out] ComputerNames

名稱指標陣列的指標。如果函式呼叫成功，此參數會傳回符合 NameType 參數中所指定電腦類型名稱的電腦名稱稱。

當應用程式不再需要此陣列時，應該藉由呼叫 NetApiBufferFree 函式釋放此緩衝區。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼或其中一個系統錯誤碼。

傳回碼	描述
ERROR_ACCESS_DENIED	存取遭到拒絕。如果呼叫端不是目的電腦上的 Administrators 本機群組成員，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	參數不正確。
ERROR_NOT_ENOUGH_MEMORY	沒有足夠的記憶體可用來處理此命令。
ERROR_NOT_SUPPORTED	不支援此要求。如果此函式執行所在的 Server 參數中指定的目的電腦是在 Windows 2000 和更早版本上執行，就會傳回此錯誤。
NERR_WkstaNotStarted	工作站服務尚未啟動。
RPC_S_CALL_IN_PROGRESS	此執行緒已經在進行遠端程序呼叫。
RPC_S_PROTSEQ_NOT_SUPPORTED	不支援遠端程序呼叫通訊協定順序。

備註

Windows Vista 和更新版本支援 NetEnumerateComputerNames 函 式。

NetEnumerateComputerNames 函式可用來要求電腦目前設定的名稱。

NetEnumerateComputerNames函式要求呼叫者是目的電腦上的 Administrators 本機群組成員。

需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	lmjoin.h (包含 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll