USE_INFO_2結構 (lmuse.h)
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 函式不會使用此元素。 定義下列值。
| 值 | 意義 |
|---|---|
|
線上成功。 |
|
由本機工作站暫停。 |
|
已中斷連接 |
|
發生錯誤。 |
|
發生網路錯誤。 |
|
正在建立連接。 |
|
重新連線。 |
ui2_asg_type
類型： DWORD
正在存取的遠端資源類型。 這個成員可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
符合伺服器的共享資源類型。 通配符只能與 NetUseAdd 函式搭配使用，而且只有在 ui2_local 成員是 NULL 字串時。 如需詳細資訊，請參閱接下來的＜備註＞一節。 |
|
磁碟裝置。 |
|
多任務緩衝印表機。 |
|
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) |