ホーム › Storage.FileServerResourceManager › IFsrmQuota

IFsrmQuota

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID377f739d-9647-4b8e-97d2-5ffce6d759cd継承元IFsrmQuotaObject呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl28

公式ドキュメント

指定したディレクトリに対するクォータを定義し、使用状況の統計情報を取得するために使用します。

解説(Remarks)

クォータは、システムまたは任意のユーザーがディレクトリ内に格納できるデータ量を制限します。

メソッド 5

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 28 HRESULT get_QuotaUsed(VARIANT* used)

このクォータに計上されている現在のディスク使用量を取得します。

used

VARIANT*

out

現在使用されている容量(バイト)を格納した VARIANT を受け取るポインタである。

解説(Remarks)

この値は、対象のディレクトリおよびそのすべてのサブディレクトリ (再帰的) における合計ディスク使用量です。ファイル、ディレクトリ、ストリーム、メタデータ、およびその他のファイルシステム固有のデータ永続化手段が使用量の算出に使用されます。

例

例については、 Getting Current Usage Values を参照してください。

vtbl 29 HRESULT get_QuotaPeakUsage(VARIANT* peakUsage)

このクォータに計上されたディスク使用量の最大値を取得します。

peakUsage

VARIANT*

out

これまでの最大使用容量(バイト)を格納した VARIANT を受け取るポインタである。

解説(Remarks)

この値は、最後に IFsrmQuota::ResetPeakUsage を呼び出して以降に、このクォータに計上されたディスク使用量の最大値を表します。この値をリセットするには、 ResetPeakUsage メソッドを呼び出します。

例

例については、 Getting Current Usage Values を参照してください。

vtbl 30 HRESULT get_QuotaPeakUsageTime(DOUBLE* peakUsageDateTime)

IFsrmQuota::QuotaPeakUsage プロパティが設定された日時を取得します。

peakUsageDateTime

DOUBLE*

out

最大使用容量に達した日時(DATE 形式)を受け取るポインタである。

解説(Remarks)

このタイムスタンプは、クォータの使用量が新たにより高いピーク値に達したとき、またはピーク使用量の値がリセットされたときに設定されます。

ピーク使用量の最大値を取得するには、 QuotaPeakUsage プロパティにアクセスします。

例

例については、 Getting Current Usage Values を参照してください。

vtbl 31 HRESULT ResetPeakUsage()

このクォータのピーク使用量を現在の使用量にリセットします。

戻り値

このメソッドは次の値を返します。

vtbl 32 HRESULT RefreshUsageProperties()

このオブジェクトのクォータ使用状況情報を、FSRM 内の現在の情報で更新します。

戻り値

このメソッドは次の値を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IFsrmQuota "{377F739D-9647-4B8E-97D2-5FFCE6D759CD}"
#usecom global IFsrmQuota IID_IFsrmQuota "{}"
#comfunc global IFsrmQuota_get_QuotaUsed           28 var
#comfunc global IFsrmQuota_get_QuotaPeakUsage      29 var
#comfunc global IFsrmQuota_get_QuotaPeakUsageTime  30 var
#comfunc global IFsrmQuota_ResetPeakUsage          31
#comfunc global IFsrmQuota_RefreshUsageProperties  32
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IFsrmQuota "{377F739D-9647-4B8E-97D2-5FFCE6D759CD}"
#usecom global IFsrmQuota IID_IFsrmQuota "{}"
#comfunc global IFsrmQuota_get_QuotaUsed           28 sptr
#comfunc global IFsrmQuota_get_QuotaPeakUsage      29 sptr
#comfunc global IFsrmQuota_get_QuotaPeakUsageTime  30 sptr
#comfunc global IFsrmQuota_ResetPeakUsage          31
#comfunc global IFsrmQuota_RefreshUsageProperties  32
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。