SHARE_INFO_503 構造体 (lmshare.h)

  • [アーティクル]

共有リソースに関する情報が含まれます。 SHARE_INFO_502 構造と 同じですが、サーバー名も含まれています。

構文

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

メンバー

shi503_netname

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

shi503_type

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

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

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

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

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

shi503_remark

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

shi503_permissions

共有レベルのセキュリティで実行されているサーバーに対する共有リソースのアクセス許可を示す DWORD 値を指定します。 Windows では共有レベルのセキュリティがサポートされていないことに注意してください。 このメンバーは、ユーザー レベルのセキュリティを実行しているサーバーでは無視されます。 セキュリティ保護可能なオブジェクトへのアクセスの制御の詳細については、「存取控制、特権、セキュリティ保護可能なオブジェクト」を参照してください。

NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

このメンバーには、次のいずれかの値を指定できます。

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

shi503_max_uses

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

shi503_current_uses

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

shi503_path

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

shi503_passwd

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

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

shi503_servername

共有リソースが存在するリモート サーバーの DNS または NetBIOS 名を指定する文字列へのポインター。 値 "*" は、構成されたサーバー名がないことを示します。

shi503_reserved

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

shi503_security_descriptor

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

解説

shi503_servername メンバーで指定されたリモート サーバーは、NetServerTransportAddEx 関数を使用してトランスポート プロトコルにバインドされている必要があります。 NetServerTransportAddEx の呼び出しでは、level パラメーターに 2 または 3 を指定し、トランスポート プロトコルのSERVER_TRANSPORT_INFO_2構造体でSVTI2_SCOPED_NAME値を指定する必要があります。

要件

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

関連項目

NetServerTransportAddEx

NetSessionDel

NetShareAdd

NetShareDelEx

NetShareEnum

NetShareGetInfo

NetShareSetInfo

ネットワーク管理の概要

ネットワーク管理構造

ネットワーク共有関数