USE_INFO_2結構 (lmuse.h)

發行項
03/05/2024

USE_INFO_2結構包含本機計算機與共用資源之間的連線相關信息，包括聯機類型、連線狀態、用戶名稱和功能變數名稱。

語法

typedef struct _USE_INFO_2 {
  LMSTR ui2_local;
  LMSTR ui2_remote;
  LMSTR ui2_password;
  DWORD ui2_status;
  DWORD ui2_asg_type;
  DWORD ui2_refcount;
  DWORD ui2_usecount;
  LMSTR ui2_username;
  LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;

成員

ui2_local

類型： LMSTR

字串的指標，其中包含本機裝置名稱 (例如，磁碟驅動器 E 或 LPT1) 重新導向至共用資源。常數 DEVLEN 會指定字串中的字元數上限。此成員可以是 NULL。如需詳細資訊，請參閱接下來的＜備註＞一節。

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

ui2_remote

類型： LMSTR

字串的指標，其中包含遠端資源的共用名。字串的格式為

\\servername\sharename

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

ui2_password

類型： LMSTR

字串的指標，其中包含使用特定工作站建立會話所需的密碼。

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

ui2_status

類型： DWORD

線上的狀態。 NetUseAdd 函式不會使用此元素。定義下列值。

值	意義
USE_OK	線上成功。
USE_PAUSED	由本機工作站暫停。
USE_SESSLOST	已中斷連接
USE_DISCONN	發生錯誤。
USE_NETERR	發生網路錯誤。
USE_CONN	正在建立連接。
USE_RECONN	重新連線。

ui2_asg_type

類型： DWORD

正在存取的遠端資源類型。這個成員可以是下列其中一個值。

值	意義
USE_WILDCARD	符合伺服器的共享資源類型。通配符只能與 NetUseAdd 函式搭配使用，而且只有在 ui2_local 成員是 NULL 字串時。如需詳細資訊，請參閱接下來的＜備註＞一節。
USE_DISKDEV	磁碟裝置。
USE_SPOOLDEV	多任務緩衝印表機。
USE_IPC	IPC) (進程間通訊。

ui2_refcount

類型： DWORD

遠端資源上開啟的檔案、目錄和其他進程數目。 NetUseAdd 函式不會使用此元素。

ui2_usecount

類型： DWORD

使用本機裝置名稱) 或隱含 UNC 連線 (重新導向的明確連線數目， (重新導向，而不需使用資源所建立的本機裝置名稱) 。

ui2_username

類型： LPWSTR

字串的指標，其中包含起始連接之用戶的名稱。

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

ui2_domainname

類型： LMSTR

字串的指標，其中包含遠端資源的功能變數名稱。

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

備註

指定UI2_LOCAL成員，該成員會向伺服器要求驗證，而不需重新導向驅動器號或裝置。當相同的連接生效時，與伺服器相關的未來重新導向會使用 NetUseAdd 函式初始呼叫中指定的驗證資訊。這項資訊包括 ui2_password、 ui2_username和 ui2_domainname 成員的組合。

規格需求

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