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 関数では使用されません。 次の値が定義されています。

値 意味
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 です。

注釈

NULL であるui2_local メンバーを指定すると、ドライブ文字やデバイスをリダイレクトすることなく、サーバーとの認証が要求されます。 同じ接続が有効な間にサーバーに関連する今後のリダイレクトでは、 NetUseAdd 関数の最初の呼び出しで指定された認証情報が使用されます。 この情報には、 ui2_password、ui2_username、 およびui2_domainnameメンバーの組み合わせ が 含まれます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header lmuse.h (Include Lm.h)

こちらもご覧ください

NetUseAdd

NetUseEnum

NetUseGetInfo

ネットワーク管理の概要

ネットワーク管理構造

関数を使用する