USE_INFO_1 結構 (lmuse.h)

發行項
08/24/2023

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函式不會使用此元素。定義下列值。

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

ui1_asg_type

類型： DWORD

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

值	意義
USE_WILDCARD	符合伺服器的共用資源類型。萬用字元只能與 NetUseAdd 函式搭配使用，而且只有在 ui1_local 成員為 Null時才使用。如需詳細資訊，請參閱接下來的＜備註＞一節。
USE_DISKDEV	磁片裝置。
USE_SPOOLDEV	多工緩衝處理印表機。
USE_IPC	IPC) (處理序間通訊。

ui1_refcount

類型： DWORD

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

ui1_usecount

類型： DWORD

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

備註

指定 ui1_local 成員 ，該成員 會要求向伺服器進行驗證，而不需重新導向磁碟機號或裝置。與伺服器相關的未來重新導向，而相同的連線實際上會使用初始呼叫NetUseAdd函式中ui1_password成員所指定的密碼。

需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	lmuse.h (包括 Lm.h)