SHARE_INFO_2結構 (lmshare.h)

發行項
08/24/2023

包含共用資源的相關資訊，包括資源的名稱、類型和許可權，以及目前的連線數目。如需控制安全性實體物件存取權的詳細資訊，請參閱存取控制、許可權和安全性實體物件。

語法

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

成員

shi2_netname

指定資源分享名稱的 Unicode 字串指標。呼叫 NetShareSetInfo 函式會忽略此成員。

shi2_type

值的組合，指定共用資源的型別。呼叫 NetShareSetInfo 函式會忽略此成員。

可以指定下列其中一個值。您可以使用 STYPE_MASK 值來隔離這些值。

值	意義
STYPE_DISKTREE	磁碟機。
STYPE_PRINTQ	列印佇列。
STYPE_DEVICE	通訊裝置。
STYPE_IPC	IPC) (處理序間通訊。

此外，也可以指定下列其中一或兩個值。

值	意義
STYPE_SPECIAL	保留給處理序間通訊的特殊共用 (IPC$) 或遠端管理伺服器 (ADMIN$) 。也可以參考系統管理共用，例如 C$、D$、E$等等。如需詳細資訊，請參閱網路共用函式。
STYPE_TEMPORARY	暫存共用。

shi2_remark

Unicode 字串的指標，其中包含有關共用資源的選擇性批註。

shi2_permissions

指定 DWORD 值，指出使用共用層級安全性執行之伺服器的共用資源許可權。執行使用者層級安全性的伺服器會忽略此成員。這個成員可以是下列一或多個值。呼叫 NetShareSetInfo 函式會忽略此成員。

請注意，Windows 不支援共用層級安全性。

值	意義
ACCESS_READ	從資源讀取資料的許可權，預設為執行資源的許可權。
ACCESS_WRITE	將資料寫入資源的許可權。
ACCESS_CREATE	建立資源實例的許可權 (，例如檔案) ;資料可以在建立資源時寫入資源。
ACCESS_EXEC	執行資源的許可權。
ACCESS_DELETE	刪除資源的許可權。
ACCESS_ATRIB	修改資源屬性的許可權 (，例如上次修改檔案的日期和時間) 。
ACCESS_PERM	修改許可權 (讀取、寫入、建立、執行和刪除) 指派給使用者或應用程式的資源。
ACCESS_ALL	讀取、寫入、建立、執行和刪除資源的許可權，以及修改其屬性和許可權。

shi2_max_uses

指定 DWORD 值，指出共用資源可容納的並行連線數目上限。如果此成員中指定的值為 –1，則連線數目無限制。

shi2_current_uses

指定指出資源目前連線數目的 DWORD 值。呼叫 NetShareSetInfo 函式會忽略此成員。

shi2_path

Unicode 字串的指標，指定共用資源的本機路徑。對於磁片， shi2_path 是共用的路徑。對於列印佇列， shi2_path 是所共用列印佇列的名稱。呼叫 NetShareSetInfo 函式會忽略此成員。

shi2_passwd

當伺服器以共用層級安全性執行時，指定共用密碼的 Unicode 字串指標。如果伺服器是以使用者層級安全性執行，則會忽略此成員。 shi2_passwd成員不能超過 SHPWLEN+1 個位元組， (包括終止的 Null 字元) 。呼叫 NetShareSetInfo 函式會忽略此成員。請注意，Windows 不支援共用層級安全性。

需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	lmshare.h (包含 Lm.h)