NetShareAdd 函式 (lmshare.h)

發行項
03/14/2023

共用伺服器資源。

語法

NET_API_STATUS NET_API_FUNCTION NetShareAdd(
  [in]  LMSTR   servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

參數

[in] servername

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

[in] level

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

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

[in] buf

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

[out] parm_err

值指標，這個值會接收造成 ERROR_INVALID_PARAMETER 錯誤之共用資訊結構之第一個成員的索引。如果此參數為 Null，則不會在錯誤時傳回索引。如需詳細資訊，請參閱 NetShareSetInfo 函式。

傳回值

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

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

傳回碼	描述
ERROR_ACCESS_DENIED	使用者無法存取要求的資訊。
ERROR_INVALID_LEVEL	為 level 參數指定的值無效。
ERROR_INVALID_NAME	字元或檔案系統名稱無效。
ERROR_INVALID_PARAMETER	指定的參數無效。
NERR_DuplicateShare	共用名稱稱已在此伺服器上使用中。
NERR_RedirectedPath	作業對重新導向的資源無效。指定的裝置名稱會指派給共用資源。
NERR_UnknownDevDir	裝置或目錄不存在。

備註

此函式僅適用于伺服器訊息區 (SMB) 共用。針對其他類型的共用，例如分散式檔案系統 (DFS) 或 WebDAV 共用，請使用支援所有類型的共用的 Windows 網路 (WNet) 函式。

只有系統管理員、系統操作員或 Power Users 本機群組的成員可以使用 NetShareAdd 函式的呼叫來新增檔案共用。列印操作員可以新增印表機共用。

如果您是針對 Active Directory 進行程式設計，您可以呼叫特定 Active Directory 服務介面 (ADSI) 方法來達成相同的功能，方法是呼叫網路管理共用函式。如需詳細資訊，請參閱 IADsFileShare。

如果為level參數指定 503，則SHARE_INFO_503結構shi503_servername成員中指定的遠端伺服器必須已使用NetServerTransportAddEx函式系結至傳輸通訊協定。在對 NetServerTransportAddEx的呼叫中，必須針對 level 參數指定 2 或 3，而且在傳輸通訊協定的 SERVER_TRANSPORT_INFO_2 結構中必須指定 SVTI2_SCOPED_NAME 旗標。

範例

下列程式碼範例示範如何使用 對 NetShareAdd 函式 的呼叫來共用網路資源。程式碼範例會填入 SHARE_INFO_2 結構的成員，並呼叫 NetShareAdd，並指定資訊層級 2。不需要密碼，因為這些平臺不支援共用層級安全性。

#ifndef UNICODE
#define UNICODE
#endif
#include <windows.h>
#include <stdio.h>
#include <lm.h>
#pragma comment(lib, "Netapi32.lib")

void wmain( int argc, TCHAR *argv[ ])
{
   NET_API_STATUS res;
   SHARE_INFO_2 p;
   DWORD parm_err = 0;

   if(argc<2)
      printf("Usage: NetShareAdd server\n");
   else
   {
      //
      // Fill in the SHARE_INFO_2 structure.
      //
      p.shi2_netname = TEXT("TESTSHARE");    
      p.shi2_type = STYPE_DISKTREE; // disk drive
      p.shi2_remark = TEXT("TESTSHARE to test NetShareAdd");
      p.shi2_permissions = 0;    
      p.shi2_max_uses = 4;
      p.shi2_current_uses = 0;    
      p.shi2_path = TEXT("C:\\");
      p.shi2_passwd = NULL; // no password
      //
      // Call the NetShareAdd function,
      //  specifying level 2.
      //
      res=NetShareAdd(argv[1], 2, (LPBYTE) &p, &parm_err);
      //
      // If the call succeeds, inform the user.
      //
      if(res==0)
         printf("Share created.\n");
      
      // Otherwise, print an error,
      //  and identify the parameter in error.
      //
      else
         printf("Error: %u\tparmerr=%u\n", res, parm_err);
   }
   return;
}

需求


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