NetShareDelEx 函式 (lmshare.h)

發行項
03/05/2024

從伺服器的共用資源清單中刪除共享名稱，這會中斷與該共用的所有連線。此函式是 NetShareDel 函式的擴充版本，可讓呼叫者指定SHARE_INFO_0、SHARE_INFO_1 、SHARE_INFO_2、SHARE_INFO_502或SHARE_INFO_503結構。

語法

NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE buf
);

參數

[in] servername

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

如果 已定義_WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。

[in] level

指定資料的資訊層級。此參數可以是下列其中一個值。

值	意義
0、1、2 或 502	指定共用資源的相關信息，包括資源的名稱、類型和許可權，以及聯機數目。 buf 參數會指向SHARE_INFO_0、SHARE_INFO_1、SHARE_INFO_2或SHARE_INFO_502結構。
503	指定共用資源的相關信息，包括資源的名稱、類型和許可權、連線數目和其他相關信息。 buf 參數指向SHARE_INFO_503結構。

[in] buf

指定數據的緩衝區指標。此數據的格式取決於 level 參數的值。如需詳細資訊，請參閱網路管理功能緩衝區。

傳回值

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

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

傳回碼	Description
ERROR_INTERNAL_ERROR	發生內部錯誤。
ERROR_INVALID_LEVEL	為 level 參數指定的值無效。
ERROR_NOT_SUPPORTED	不支援此要求。

備註

如果為 level 參數指定 503，buf 參數會指向SHARE_INFO_503結構，並使用該結構的shi503_netname和shi503_servername成員來查閱伺服器上的共享資源;會忽略其他成員。 shi503_servername成員中指定的遠端伺服器必須使用 NetServerTransportAddEx 函式系結至傳輸通訊協定。在 NetServerTransportAddEx 的呼叫中，必須為 level 參數指定 2 或 3，而且必須在傳輸通訊協定的 SERVER_TRANSPORT_INFO_2 結構中指定 SVTI2_SCOPED_NAME 旗標。

如果為 level 參數指定 0、1、2 或 502，buf 參數會指向SHARE_INFO_0、SHARE_INFO_1、SHARE_INFO_2 或SHARE_INFO_502結構，以及使用該結構的shi0_netname、shi1_netname、shi2_netname或shi502_netname成員;會忽略其他成員。

規格需求

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