IVssHardwareSnapshotProvider::AreLunsSupported メソッド (vsprov.h)
Are LunsSupported メソッドは、ハードウェア プロバイダーがボリュームに寄与するすべての LUN のシャドウ コピーの作成をサポートするかどうかを決定します。 VSS は、シャドウ コピー セットに追加されるボリュームごとに AreLunsSupported メソッドを呼び出します。 このメソッドを呼び出す前に、VSS はボリュームに寄与する LUN を決定します。
特定のボリュームの場合、各 LUN は 1 回だけ投稿できます。 特定の LUN が複数のボリュームに影響を与える可能性があります。
構文
HRESULT AreLunsSupported(
[in] LONG lLunCount,
[in] LONG lContext,
[in] VSS_PWSZ *rgwszDevices,
[in, out] VDS_LUN_INFORMATION *pLunInformation,
[out] BOOL *pbIsSupported
);
パラメーター
[in] lLunCount
このシャドウ コピー ボリュームに寄与する LUN の数。
[in] lContext
_VSS_VOLUME_SNAPSHOT_ATTRIBUTES列挙体のフラグのビットマスクによって列挙された現在のシャドウ コピー セットのシャドウ コピー コンテキスト。 VSS_VOLSNAP_ATTR_TRANSPORTABLE フラグが設定されている場合、シャドウ コピー セットは転送可能です。
[in] rgwszDevices
シャドウ コピーする LUN に対応するデバイスの一覧。
[in, out] pLunInformation
l LunCountVDS_LUN_INFORMATION構造体の配列。このシャドウ コピー ボリュームに寄与する LUN ごとに 1 つ。
[out] pbIsSupported
BOOL 値へのポインター。 すべてのデバイスがシャドウ コピーでサポートされている場合、プロバイダーは pbIsSupported が指す場所に TRUE 値を格納する必要があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード/値 | Description |
---|---|
|
操作が正常に完了しました。 |
|
メモリ不足またはその他のシステム リソース。 |
|
パラメーター値の 1 つが無効です。 |
|
予期しないプロバイダー エラーが発生しました。 プロバイダーは、問題を解決する方法に関する情報をユーザーに提供するアプリケーション イベント ログにイベントを報告する必要があります。 |
注釈
ハードウェア サブシステムが SCSI 照会データおよび重要な製品データ ページ 80 (デバイスシリアル番号) およびページ 83 (デバイス ID) ガイドラインをサポートしている場合、プロバイダーは pLunInformation 配列の構造を変更する必要はありません。
いずれの場合も、AreLunsSupported メソッドは、pLunInformation 配列のVDS_LUN_INFORMATION構造体のm_rgInterconnects メンバーの値を変更しないでください。
プロバイダーが p LunInformation 配列内のすべての LUN のハードウェア シャドウ コピーの作成をサポートしている場合は、pbIsSupported パラメーターが指す BOOL 値で TRUE を返す必要があります。 プロバイダーが 1 つ以上の LUN のハードウェア シャドウ コピーをサポートしていない場合は、この BOOL 値を FALSE に設定する必要があります。
プロバイダーがシャドウ コピーを作成できない場合は、問題が一時的なものであっても作成することに同意してはなりません。 リソースの不足などの一時的な条件によって、 Are LunsSupported が呼び出されたときにプロバイダーが 1 つ以上の LUN を使用してシャドウ コピーを作成できない場合、プロバイダーは BOOL 値を FALSE に設定する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | vsprov.h |