Class: WMI::Win32_Share

Inherits:
Base
  • Object
show all
Defined in:
lib/Win32_Share.rb

Overview

Win32_Share クラスは、Win32 システムの共有リソースを表します。これは、ディスク ドライブ、プリンタ、プロセス間通信またはほかの共有可能デバイスである可能性があります。 例: C:\PUBLIC

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Methods inherited from Base

#AddRef, #AssociatorsAsync_, #Associators_, #Clone_, #CompareTo_, #DeleteAsync_, #Delete_, #Derivation_, #ExecMethodAsync_, #ExecMethod_, #GetIDsOfNames, #GetObjectText_, #GetText_, #GetTypeInfo, #GetTypeInfoCount, #InstancesAsync_, #Instances_, #Invoke, #Methods_, #Path_, #Properties_, #PutAsync_, #Put_, #Qualifiers_, #QueryInterface, #ReferencesAsync_, #References_, #Refresh_, #Release, #Security_, #SetFromText_, #SpawnDerivedClass_, #SpawnInstance_, #SubclassesAsync_, #Subclasses_, #SystemProperties_

Instance Attribute Details

- (uint32) AccessMask (readonly)

このプロパティは、GetEffectiveRightsFromAcl を呼び出しているため、このクラスの GetAccessMask メソッドのために使用されていません。

 

Returns:

  • (uint32)

    AccessMask



147
148
149
# File 'lib/Win32_Share.rb', line 147

def AccessMask
  @AccessMask
end

- (boolean) AllowMaximum (readonly)

AllowMaximum プロパティは、このリソースを同時に使用しているユーザーの数が制限されているかどうかを示します。

 

Returns:

  • (boolean)

    AllowMaximum



155
156
157
# File 'lib/Win32_Share.rb', line 155

def AllowMaximum
  @AllowMaximum
end

- (string) Caption (readonly)

Caption プロパティは、オブジェクトについての簡単な説明 (1 行分の文字列) です。

Returns:

  • (string)

    Caption



160
161
162
# File 'lib/Win32_Share.rb', line 160

def Caption
  @Caption
end

- (string) Description (readonly)

Description プロパティでオブジェクトの説明が提供されます。

Returns:

  • (string)

    Description



166
167
168
# File 'lib/Win32_Share.rb', line 166

def Description
  @Description
end

- (datetime) InstallDate (readonly)

InstallDate プロパティは、オブジェクトがインストールされた日時を示す値です。

 

Returns:

  • (datetime)

    InstallDate



172
173
174
# File 'lib/Win32_Share.rb', line 172

def InstallDate
  @InstallDate
end

- (uint32) MaximumAllowed (readonly)

MaximumAllowed プロパティにより、このリソースを同時に使用できる最大ユーザー数の制限が渡されます。

 

Returns:

  • (uint32)

    MaximumAllowed



180
181
182
# File 'lib/Win32_Share.rb', line 180

def MaximumAllowed
  @MaximumAllowed
end

- (string) Name (readonly)

Name プロパティは、Win32 システム上の共有として設定されたパスに与えられたエイリアスを示します。

 

Returns:

  • (string)

    Name



187
188
189
# File 'lib/Win32_Share.rb', line 187

def Name
  @Name
end

- (string) Path (readonly)

Path プロパティは、Win32 共有のローカル パスを示します。

 

Returns:

  • (string)

    Path



194
195
196
# File 'lib/Win32_Share.rb', line 194

def Path
  @Path
end

- (string) Status (readonly)

Status プロパティはオブジェクトの現在の状態を示す文字列です。

 

Returns:

  • (string)

    Status



207
208
209
# File 'lib/Win32_Share.rb', line 207

def Status
  @Status
end

- (uint32) Type (readonly)

Type プロパティにより、共有されるリソースの種類が指定されます。

 

Returns:

  • (uint32)

    Type



213
214
215
# File 'lib/Win32_Share.rb', line 213

def Type
  @Type
end

Instance Method Details

- (uint32) Create(Access, Description, MaximumAllowed, Name, Password, Path, Type)

Create メソッドはサーバー リソースの共有を開始します。 管理者またはアカウント オペレータ ローカル グループのメンバか、または通信オペレータ、プリント オペレータ、サーバー オペレータ グループのメンバシップがあるメンバのみが、正常に Create を実行できます。 プリント オペレータはプリンタのキューのみを追加できます。 通信オペレータは通信デバイスのキューのみを追加できます。 メソッドは次のように変換される整数値を返します: 0 - 正常に完了しました。

2 - ユーザーは要求された情報に対するアクセス権がありません。

8 - 不明なエラーです。

9 - 文字またはファイル システム名が無効です。

10 - レベル パラメータに指定された値が無効です。

21 - 指定されたパラメータは無効です。

22 - 共有名はこのサーバーで既に使用されています。

23 - この操作はリダイレクトされたリソース上では無効です。 指定されたデバイス名は共有リソースに割り当てられます。

24 - デバイスまたはディレクトリは存在しません。

25 - 共有名は存在しません。

その他 - 上の一覧以外の整数値については Win32 エラー コードのドキュメントを参照してください。

Parameters:

  • (Win32_SecurityDescriptor, #read) Access

    Access パラメータにより、ユーザー レベルのアクセス許可に対してセキュリティ記述子が渡されます。 セキュリティ記述子には、アクセス権、所有者、およびリソースのアクセス機能に関する情報が含まれています。

  • (string, #read) Description

    Description パラメータにより、共有されているリソースを説明するオプション コメントが渡されます。

  • (uint32, #read) MaximumAllowed

    MaximumAllowed パラメータにより、このリソースを同時に使用できる最大ユーザー数の制限が渡されます。

    例: 10

  • (string, #read) Name
    名前
    パラメータは、Win32 システム上に共有として設定されるパスにエイリアスを渡します。

    例: public

  • (string, #read) Password

    Password パラメータにより、(サーバーが共有レベルのセキュリティで実行しているとき) 共有リソースのパスワードが渡されます。 サーバーがユーザー レベルのセキュリティで実行している場合、このパラメータは無視されます。

  • (string, #read) Path
    パス
    パラメータは、Win32 共有のローカル パスを示します。

    例: C:\Program Files

  • (uint32, #read) Type

    Type パラメータにより、共有されるリソースの種類が渡されます。 種類には、ディスク ドライブ、印刷キュー、プロセス間通信 (IPC)、および一般デバイスが含まれます。

Returns:

  • (uint32)


57
58
# File 'lib/Win32_Share.rb', line 57

def Create Access, Description, MaximumAllowed, Name, Password, Path, Type
end

- (uint32) Delete

Delete メソッドは、共有リソースへの接続を切断して、サーバーの共有リソースの一覧から共有名を削除します。 管理者またはアカウント オペレータ ローカル グループのメンバか、または通信オペレータ、プリント オペレータ、サーバー オペレータ グループのメンバシップがあるメンバのみが、正常にメソッドを実行できます。 プリンタ オペレータはプリンタ キューのみを削除できます。 通信オペレータは通信デバイスのキューのみを削除できます。

メソッドは次のように変換される整数値を返します: 0 - 正常に完了しました。

2 - ユーザーは要求された情報に対するアクセス権がありません。

8 - 不明なエラーです。

9 - 文字またはファイル システム名が無効です。

10 - レベル パラメータに指定された値が無効です。

21 - 指定されたパラメータは無効です。

22 - 共有名はこのサーバーで既に使用されています。

23 - この操作はリダイレクトされたリソース上では無効です。 指定されたデバイス名は共有リソースに割り当てられます。

24 - デバイスまたはディレクトリは存在しません。

25 - 共有名は存在しません。

その他 - 上の一覧以外の整数値については Win32 エラー コードのドキュメントを参照してください

Returns:

  • (uint32)


140
141
# File 'lib/Win32_Share.rb', line 140

def Delete 
end

- (uint32) GetAccessMask

AccessMask メソッドにより、ユーザーまたはグループが保持している共有へのアクセス権が返されます。 このユーザーまたはグループの代わりにインスタンスが返されます。 このプロパティは、Windows NT/Windows 2000 システムでのみサポートされます。

Returns:

  • (uint32)


107
108
# File 'lib/Win32_Share.rb', line 107

def GetAccessMask 
end

- (uint32) SetShareInfo(Access, Description, MaximumAllowed)

SetShareInfo メソッドは共有リソースのパラメータを設定します。 管理者またはアカウント オペレータ ローカル グループのメンバか、または通信オペレータ、プリント オペレータ、サーバー オペレータ グループのメンバシップがあるメンバのみが、正常に SetShareInfo を実行できます。 プリンタ オペレータはプリンタ キューのみを設定できます。 通信オペレータは通信デバイスのキューのみを設定できます。

メソッドは次のように変換される整数値を返します: 0 - 正常に完了しました。

2 - ユーザーは要求された情報に対するアクセス権がありません。

8 - 不明なエラーです。

9 - 文字またはファイル システム名が無効です。

10 - レベル パラメータに指定された値が無効です。

21 - 指定されたパラメータは無効です。

22 - 共有名はこのサーバーで既に使用されています。

23 - この操作はリダイレクトされたリソース上では無効です。 指定されたデバイス名は共有リソースに割り当てられます。

24 - デバイスまたはディレクトリは存在しません。

25 - 共有名は存在しません。

その他 - 上の一覧以外の整数値については Win32 エラー コードのドキュメントを参照してください。

Parameters:

  • (Win32_SecurityDescriptor, #read) Access

    Access パラメータにより、ユーザー レベルのアクセス許可に対してセキュリティ記述子が渡されます。 セキュリティ記述子には、アクセス権、所有者、およびリソースのアクセス機能に関する情報が含まれています。

  • (string, #read) Description

    Description パラメータにより、共有されているリソースを説明するオプション コメントが渡されます。

  • (uint32, #read) MaximumAllowed

    MaximumAllowed パラメータにより、このリソースを同時に使用できる最大ユーザー数の制限が渡されます。

    例: 10

Returns:

  • (uint32)


99
100
# File 'lib/Win32_Share.rb', line 99

def SetShareInfo Access, Description, MaximumAllowed
end