SHARE_INFO_503結構 (lmshare.h)

發行項
08/24/2023

包含共用資源的相關資訊。它與 SHARE_INFO_502 結構相同，不同之處在于它也會包含伺服器名稱。

語法

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

成員

shi503_netname

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

shi503_type

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

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

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

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

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

shi503_remark

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

shi503_permissions

指定 DWORD 值，指出使用共用層級安全性執行之伺服器的共用資源許可權。請注意，Windows 不支援共用層級安全性。在執行使用者層級安全性的伺服器上會忽略此成員。如需控制安全性實體物件存取權的詳細資訊，請參閱存取控制、許可權和安全性實體物件。

呼叫 NetShareSetInfo 函式會忽略此成員。

這個成員可以是下列任何值。

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

shi503_max_uses

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

shi503_current_uses

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

shi503_path

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

shi503_passwd

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

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

shi503_servername

字串的指標，指定共用資源所在遠端伺服器的 DNS 或 NetBIOS 名稱。值「*」表示沒有設定的伺服器名稱。

shi503_reserved

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

shi503_security_descriptor

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

備註

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

需求


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