SHARE_INFO_2 構造体 (lmshare.h)

  • [アーティクル]

リソースの名前、種類とアクセス許可、現在の接続の数など、共有リソースに関する情報が含まれます。 セキュリティ保護可能なオブジェクトへのアクセスの制御の詳細については、「存取控制、特権、セキュリティ保護可能なオブジェクト」を参照してください。

構文

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

メンバー

shi2_netname

リソースの共有名を指定する Unicode 文字列へのポインター。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

shi2_type

共有リソースの種類を指定する値の組み合わせ。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

次のいずれかの値を指定できます。 これらの値は、 STYPE_MASK 値を使用して分離できます。

値 説明
STYPE_DISKTREE
 ディスク ドライブ。
STYPE_PRINTQ
 印刷キュー。
STYPE_DEVICE
 通信デバイス。
STYPE_IPC
 プロセス間通信 (IPC)。
 

また、次の値の一方または両方を指定することもできます。

値 説明
STYPE_SPECIAL
 プロセス間通信 (IPC$) またはサーバーのリモート管理 (ADMIN$) 用に予約された特別な共有。 C$、D$、E$ などの管理共有を参照することもできます。 詳細については、「 ネットワーク共有関数」を参照してください。
STYPE_TEMPORARY
 一時的な共有。

shi2_remark

共有リソースに関するオプションのコメントを含む Unicode 文字列へのポインター。

shi2_permissions

共有レベルのセキュリティで実行されているサーバーに対する共有リソースのアクセス許可を示す DWORD 値を指定します。 ユーザー レベルのセキュリティを実行しているサーバーは、このメンバーを無視します。 このメンバーには、次の値の 1 つ以上を指定できます。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

Windows では共有レベルのセキュリティがサポートされていないことに注意してください。

値 説明
ACCESS_READ
 リソースからデータを読み取り、既定でリソースを実行するためのアクセス許可。
ACCESS_WRITE
 リソースにデータを書き込むアクセス許可。
ACCESS_CREATE
 リソースのインスタンス (ファイルなど) を作成するためのアクセス許可。データは、リソースの作成時にリソースに書き込むことができます。
ACCESS_EXEC
 リソースを実行するためのアクセス許可。
ACCESS_DELETE
 リソースを削除するアクセス許可。
ACCESS_ATRIB
 リソースの属性 (ファイルが最後に変更された日時など) を変更するためのアクセス許可。
ACCESS_PERM
 ユーザーまたはアプリケーションのリソースに割り当てられているアクセス許可 (読み取り、書き込み、作成、実行、削除) を変更するためのアクセス許可。
ACCESS_ALL
 リソースの読み取り、書き込み、作成、実行、削除、および属性とアクセス許可の変更を行うアクセス許可。

shi2_max_uses

共有リソースが対応できる同時接続の最大数を示す DWORD 値を指定します。 このメンバーで指定された値が –1 の場合、接続の数は無制限です。

shi2_current_uses

リソースへの現在の接続の数を示す DWORD 値を指定します。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

shi2_path

共有リソースのローカル パスを指定する Unicode 文字列へのポインター。 ディスクの場合、 shi2_path は共有されているパスです。 印刷キューの場合、 shi2_path は共有されている印刷キューの名前です。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

shi2_passwd

サーバーが共有レベルのセキュリティで実行されているときに共有のパスワードを指定する Unicode 文字列へのポインター。 サーバーがユーザー レベルのセキュリティで実行されている場合、このメンバーは無視されます。 shi2_passwd メンバーは、SHPWLEN+1 バイト (終端の null 文字を含む) を超えることはできません。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。 Windows では共有レベルのセキュリティがサポートされていないことに注意してください。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header lmshare.h (include Lm.h)

関連項目

NetShareAdd

NetShareEnum

NetShareGetInfo

NetShareSetInfo

ネットワーク管理の概要

ネットワーク管理構造

ネットワーク共有関数