次の方法で共有

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

値 説明
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 接続 (ローカル デバイス名のないリダイレクト) の数。

解説

NULL であるui1_local メンバーを指定すると、ドライブ文字やデバイスをリダイレクトすることなく、サーバーとの認証が要求されます。 同じ接続が有効な間にサーバーに関連する今後のリダイレクトでは、NetUseAdd 関数の最初の呼び出しで、ui1_password メンバーによって指定されたパスワードが使用されます。

要件

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

関連項目

NetUseAdd

NetUseEnum

NetUseGetInfo

ネットワーク管理の概要

ネットワーク管理構造

関数を使用する