共用方式為

WTSEnumerateServersW 函式 （wtsapi32.h）

  • 發行項

傳回指定網域內所有遠端桌面會話主機 （RD 工作階段主機） 伺服器的清單。

語法

BOOL WTSEnumerateServersW(
  [in] LPWSTR            pDomainName,
  [in] DWORD             Reserved,
  [in] DWORD             Version,
       PWTS_SERVER_INFOW *ppServerInfo,
       DWORD             *pCount
);

參數

[in] pDomainName

要查詢之功能變數名稱的指標。 如果此參數的值是 NULL，則指定的定義域是目前的定義域。

[in] Reserved

保留。 此參數的值必須是 0。

[in] Version

列舉要求的版本。 參數的值必須是 1。

ppServerInfo

指向 WTS_SERVER_INFO 結構的陣列，其中包含列舉的傳回結果。 使用之後，應該呼叫 WTSFreeMemory來釋放此緩衝區所使用的記憶體。

pCount

變數的指標，這個變數會接收 ppServerInfo 緩衝區中傳回的 WTS_SERVER_INFO 結構數目。

傳回值

如果函式成功，則傳回值是非零值。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

如果 NetBT 已停用，此函式將無法運作。

注意

wtsapi32.h 標頭會根據 UNICODE 預處理器常數的定義，將 WTSEnumerateServers 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista
支援的最低伺服器 Windows Server 2008
目標平臺 窗戶
標頭 wtsapi32.h
連結庫 Wtsapi32.lib
DLL Wtsapi32.dll

另請參閱

WTS_SERVER_INFO