SHARE_INFO_502結構 (lmshare.h)

發行項
03/05/2024

包含共用資源的相關信息，包括資源的名稱、類型和許可權、連線數目和其他相關信息。

語法

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

成員

shi502_netname

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

shi502_type

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

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

值	意義
STYPE_DISKTREE	磁碟驅動器。
STYPE_PRINTQ	列印佇列。
STYPE_DEVICE	通訊裝置。
STYPE_IPC	IPC) (進程間通訊。

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

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

shi502_remark

Unicode 字串的指標，指定有關共用資源的選擇性批注。

shi502_permissions

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

請注意，Windows 不支援共用層級安全性。如需控制安全性實體物件存取權的詳細資訊，請參閱存取控制、許可權和安全性實體物件。

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

shi502_max_uses

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

shi502_current_uses

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

shi502_path

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

shi502_passwd

當伺服器以共用層級安全性) 執行時，指定共用密碼 (的 Unicode 字串指標。如果伺服器是以用戶層級安全性執行，則會忽略此成員。請注意，Windows 不支援共用層級安全性。

這個成員不能超過SHPWLEN+1個字節， (包括終止的 Null 字元) 。呼叫 NetShareSetInfo 函式會忽略此成員。

shi502_reserved

保留;必須是零。呼叫 NetShareSetInfo 函式會忽略此成員。

shi502_security_descriptor

指定與此共用相關聯的 SECURITY_DESCRIPTOR 。

規格需求

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