NetServerComputerNameAdd 函式 (lmserver.h)

發行項
02/28/2024

NetServerComputerNameAdd 函式會列舉指定伺服器作用中的傳輸，並將仿真的伺服器名稱系結至每個傳輸。

NetServerComputerNameAdd 是一個公用程式函式，結合了 NetServerTransportEnum 函式和 NetServerTransportAddEx 函式的功能。

語法

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

參數

[in] ServerName

字串的指標，指定要在其中執行函式之遠端伺服器的名稱。如果此參數為 NULL，則會使用本機電腦。

[in] EmulatedDomainName

字串的指標，這個字串包含指定伺服器應該在宣告其目前狀態時使用 EmulatedServerName 時，應該使用的功能變數名稱。這是選擇性參數。

[in] EmulatedServerName

包含模擬名稱的 Null 終止字元字串指標，除了 ServerName 參數所指定的名稱之外，伺服器應該要開始支持的名稱。

傳回值

如果函式成功，傳回值會NERR_Success。請注意，如果指定的模擬伺服器名稱新增至至少一個傳輸， NetServerComputerNameAdd 就會成功。

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

傳回碼	Description
ERROR_ACCESS_DENIED	用戶無法存取要求的資訊。
ERROR_DUP_NAME	網路上存在重複的名稱。
ERROR_INVALID_DOMAINNAME	在網路上找不到功能變數名稱。
ERROR_INVALID_PARAMETER	指定的參數無效。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足。

備註

只有 Administrators 或 Server Operators 本地組的成員才能成功執行 NetServerComputerNameAdd 函式 。

ServerName 參數所指定的伺服器會繼續支援它支援的所有名稱，此外，也開始支援 NetServerComputerNameAdd 函式成功呼叫所提供的新名稱。

呼叫 NetServerComputerNameAdd 所產生的名稱模擬會在伺服器重新啟動或重新啟動時停止。若要停止先前呼叫 NetServerComputerNameAdd 而不需要重新啟動或重新啟動的名稱模擬，您可以呼叫 NetServerComputerNameDel 函式。

NetServerComputerNameAdd 函式通常用於系統管理員取代伺服器，但想要讓使用者保持透明轉換。

範例

以下是 呼叫 NetServerComputerNameAdd 函式的範例，要求 \Server1 也會回應 \Server2 的要求。

NetServerComputerNameAdd (Server1, NULL, Server2);

規格需求

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