USE_INFO_1 結構 (lmuse.h)
USE_INFO_1結構包含本機裝置與共用資源之間的連線相關資訊。 此資訊包括線上狀態和連線類型。
語法
typedef struct _USE_INFO_1 {
LMSTR ui1_local;
LMSTR ui1_remote;
LMSTR ui1_password;
DWORD ui1_status;
DWORD ui1_asg_type;
DWORD ui1_refcount;
DWORD ui1_usecount;
} USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;
成員
ui1_local
類型： LMSTR
字串的指標，其中包含本機裝置名稱 (例如磁片磁碟機 E 或 LPT1) 重新導向至共用資源。 常數 DEVLEN 會指定字串中的字元數上限。 這個成員可以是 Null。 如需詳細資訊，請參閱接下來的＜備註＞一節。
如果已定義 _WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。
ui1_remote
類型： LMSTR
字串的指標，其中包含所存取之遠端資源的共用名稱稱。 字串的格式如下：
\\servername\sharename
如果已定義 _WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。
ui1_password
類型： LMSTR
字串的指標，其中包含建立特定工作站與伺服器之間會話所需的密碼。
如果已定義 _WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。
ui1_status
類型： DWORD
連線的狀態。 NetUseAdd函式不會使用此元素。 定義下列值。
| 值 | 意義 |
|---|---|
|
連線有效。 |
|
由本機工作站暫停。 |
|
已中斷連接 |
|
發生錯誤。 |
|
發生網路錯誤。 |
|
正在建立連線。 |
|
重新連線。 |
ui1_asg_type
類型： DWORD
要存取的遠端資源類型。 這個成員可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
符合伺服器的共用資源類型。 萬用字元只能與 NetUseAdd 函式搭配使用，而且只有在 ui1_local 成員為 Null時才使用。 如需詳細資訊，請參閱接下來的＜備註＞一節。 |
|
磁片裝置。 |
|
多工緩衝處理印表機。 |
|
IPC) (處理序間通訊。 |
ui1_refcount
類型： DWORD
遠端資源上開啟的檔案、目錄和其他進程數目。 NetUseAdd函式不會使用此元素。
ui1_usecount
類型： DWORD
使用本機裝置名稱) 或隱含 UNC 連線 (重新導向的明確連線數目， (重新導向，而不需使用資源建立的本機裝置名稱) 。
備註
指定 ui1_local 成員 ，該成員 會要求向伺服器進行驗證，而不需重新導向磁碟機號或裝置。 與伺服器相關的未來重新導向，而相同的連線實際上會使用初始呼叫NetUseAdd函式中ui1_password成員所指定的密碼。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | lmuse.h (包括 Lm.h) |