SHARE_INFO_502構造体 (lmshare.h)

[アーティクル]
08/24/2023

リソースの名前、種類とアクセス許可、接続の数、およびその他の関連情報など、共有リソースに関する情報が含まれます。

構文

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

メンバー

shi502_netname

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

shi502_type

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

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

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

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

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

shi502_remark

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

shi502_permissions

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

Windows では共有レベルのセキュリティがサポートされていないことに注意してください。セキュリティ保護可能なオブジェクトへのアクセスの制御の詳細については、「Access Control、特権、セキュリティ保護可能なオブジェクト」を参照してください。

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

shi502_max_uses

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

shi502_current_uses

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

shi502_path

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

shi502_passwd

共有のパスワードを指定する Unicode 文字列へのポインター (サーバーが共有レベルのセキュリティで実行されている場合)。サーバーがユーザーレベルのセキュリティで実行されている場合、このメンバーは無視されます。 Windows では共有レベルのセキュリティがサポートされていないことに注意してください。

このメンバーは、SHPWLEN+1 バイト (終端の null 文字を含む) を超えることはできません。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

shi502_reserved

予約;は 0 である必要があります。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

shi502_security_descriptor

この共有に関連付けられている SECURITY_DESCRIPTOR を指定します。

要件

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