Win32 API 日本語リファレンス
ホームStorage.VirtualDiskService › IVdsPack

IVdsPack

COM
IID3b69d7f5-9d94-4648-91ca-79939ba263bf継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ディスクとボリュームを含むパックに対して、照会や管理操作を実行するためのメソッドを提供します。

メソッド 10

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetProperties(VDS_PACK_PROP* pPackProp)

パックオブジェクトのプロパティの詳細を返します。

pPackPropVDS_PACK_PROP*out呼び出し元が渡す VDS_PACK_PROP 構造体のアドレスです。VDS は pwszName メンバーのメモリを割り当てます。呼び出し元は CoTaskMemFree 関数を使用して文字列を解放する必要があります。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
メソッドは正常に完了しました。
VDS_S_PROPERTIES_INCOMPLETE
0x00042715L
一部のプロパティは正常に取得されましたが、すべてではありません。デバイスの取り外しなど、すべてのプロパティの取得に失敗する原因は数多くあることに注意してください。
vtbl 4 HRESULT GetProvider(IVdsProvider** ppProvider)

パックに関連付けられているソフトウェアプロバイダーを返します。

ppProviderIVdsProvider**outIVdsProvider インターフェイスポインターのアドレスです。呼び出し元はインターフェイスを解放する必要があります。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
プロバイダーオブジェクトが正常に返されました。
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
ダイナミックプロバイダーのキャッシュが破損しています。
vtbl 5 HRESULT QueryVolumes(IEnumVdsObject** ppEnum)

パック内のボリュームを列挙するオブジェクトを返します。

ppEnumIEnumVdsObject**outボリュームを ボリュームオブジェクト として列挙するために使用できる IEnumVdsObject インターフェイスポインターのアドレスです。詳細については、「列挙オブジェクトの操作」を参照してください。呼び出し元は、インターフェイスおよび各ボリュームオブジェクトが不要になったときに、IUnknown::Release メソッドを呼び出して解放する必要があります。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
列挙が正常に返されました。
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
ダイナミックプロバイダーのキャッシュが破損しています。
vtbl 6 HRESULT QueryDisks(IEnumVdsObject** ppEnum)

パック内のディスクを列挙するオブジェクトを返します。

ppEnumIEnumVdsObject**outディスクを ディスクオブジェクト として列挙するために使用できる IEnumVdsObject インターフェイスポインターのアドレスです。詳細については、「列挙オブジェクトの操作」を参照してください。呼び出し元は、インターフェイスおよび各ディスクオブジェクトが不要になったときに、IUnknown::Release メソッドを呼び出して解放する必要があります。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
列挙が正常に返されました。
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
ダイナミックプロバイダーのキャッシュが破損しています。
vtbl 7 HRESULT CreateVolume(VDS_VOLUME_TYPE type, VDS_INPUT_DISK* pInputDiskArray, INT lNumberOfDisks, DWORD ulStripeSize, IVdsAsync** ppAsync)

パック内にボリュームを作成します。

typeVDS_VOLUME_TYPEinVDS_VOLUME_TYPE で列挙されるボリュームの種類です。 ベーシックディスク上のボリュームはエクステントを1つしか持てず、VDS_VT_SIMPLE フラグのみが 有効です。
pInputDiskArrayVDS_INPUT_DISK*inVDS_INPUT_DISK 構造体の配列へのポインターです。ディスク1つにつき1つの構造体を指定します。1つのディスクを配列に含められるのは1回だけです。配列内のすべてのディスクが使用される必要があり、そうでない場合はメソッドが失敗します。呼び出し元は配列を割り当てて初期化し、呼び出しから戻ったときにメモリを解放する必要があります。
lNumberOfDisksINTin

ボリュームを構成するディスクの総数です。

注意 VDS は、スパンボリューム、ストライプボリューム、およびパリティ付きストライプ (RAID-5) ボリュームに32ディスクの制限を課します。
ulStripeSizeDWORDinボリュームがストライプの場合は、各ストライプのサイズ (バイト単位) です。 VDS_VT_SIMPLEVDS_VT_SPANVDS_VT_MIRROR の場合は0バイトを渡し、VDS_VT_STRIPEVDS_VT_PARITY の場合は64キロバイトを渡します。
ppAsyncIVdsAsync**out

IVdsAsync インターフェイスポインターの アドレスで、VDS が戻り時に初期化します。呼び出し元はインターフェイスを解放する必要があります。このポインターを使用して、操作のキャンセル、完了の待機、 または状態の照会を行います。

このメソッドで IVdsAsync::Wait を呼び出して成功を示す HRESULT 値が返された場合は、 各インターフェイスポインターに対して IUnknown::Release メソッドを呼び出して、 VDS_ASYNC_OUTPUT 構造体で返されたインターフェイスを解放する必要があります。ただし、Wait が失敗を示す HRESULT 値を返した場合、または WaitpHrResult パラメーターが失敗を示す HRESULT 値を受け取った場合は、VDS_ASYNC_OUTPUT 構造体内のインターフェイスポインターは NULL であり、解放する必要はありません。成功または失敗の HRESULT 値は、Winerror.h で定義されている SUCCEEDED および FAILED マクロを使用してテストできます。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
ボリュームが正常に作成されました。
VDS_S_NO_NOTIFICATION
0x00042517L
ボリューム到着の通知を受信しませんでした。IVdsService::Refresh の呼び出しが必要になる場合があります。
VDS_S_UPDATE_BOOTFILE_FAILED
0x00042434L
ボリュームは正常に作成されましたが、VDS はブート構成データ (BCD) ストア内のブートオプションの更新に失敗しました。

Windows Server 2003: ブートオプションは、x86 または x64 システムでは boot.ini ファイルに、 Itanium システムでは NVRAM に格納されます。

VDS_E_DISK_NOT_FOUND_IN_PACK
0x8004252DL
指定されたディスクは同じパックに属していません。
VDS_E_DMADMIN_METHOD_CALL_FAILED
0x80042420L
LDM サービスがメソッドに失敗しました。
VDS_E_EXTENT_SIZE_LESS_THAN_MIN
0x80042433L
渡されたエクステントサイズが小さすぎます。
VDS_E_INVALID_DISK_COUNT
0x80042526L
指定されたディスクの数は、この操作に対して有効ではありません。
VDS_E_INVALID_MEMBER_COUNT
0x80042522L
ボリュームのメンバー数は0より大きい必要があります。
VDS_E_INVALID_MEMBER_ORDER
0x80042524L
メンバーのインデックスは0から始まり、単調に増加する必要があります。
VDS_E_INVALID_OPERATION
0x80042415L
渡されたディスクは CD-ROM または DVD デバイスです。
VDS_E_INVALID_PACK
0x8004251AL
この操作は、このディスクパックでは許可されていません。
VDS_E_INVALID_PLEX_COUNT
0x80042521L
ボリュームのプレックス数は0より大きい必要があります。
VDS_E_INVALID_PLEX_ORDER
0x80042523L
プレックスのインデックスは0から始まり、単調に増加する必要があります。
VDS_E_INVALID_STRIPE_SIZE
0x80042525L
ストライプサイズ (バイト単位) は、ストライプおよび RAID-5 ボリュームの種類の場合は2のべき乗である必要があり、その他すべてのボリュームの種類の場合は0である必要があります。
VDS_E_MISSING_DISK
0x80042454L
指定されたディスクが欠落しています。
VDS_E_NO_MEDIA
0x80042412L
ディスク配列を通じて渡されたリムーバブルドライブにメディアがありません。
VDS_E_NOT_ENOUGH_SPACE
0x8004240FL
いずれかのディスクに十分な空き領域がありません。
VDS_E_NOT_SUPPORTED
0x80042400L
ボリュームの種類がサポートされていないか、メソッドに渡されたリムーバブルディスクに既にボリュームが存在します。リムーバブルディスクはボリュームを1つしか 持てません。
VDS_E_OBJECT_NOT_FOUND
0x80042405L
渡されたディスクのうち少なくとも1つが見つかりません。
VDS_E_ONE_EXTENT_PER_DISK
0x80042531L
1つのディスクが、同じボリュームの複数のメンバーまたは複数のプレックスを構成することはできません。
VDS_E_PACK_OFFLINE
0x80042444L
対象のパックにアクセスできません。
VDS_E_PARTITION_LIMIT_REACHED
0x80042407L
呼び出し元が追加のプライマリパーティションまたは拡張パーティションを作成しようとしたときに、パーティション (プライマリパーティション、または拡張パーティションを含むプライマリパーティション) の 最大数に既に達しています。
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
ダイナミックプロバイダーのキャッシュが破損しています。
VDS_E_VOLUME_DISK_COUNT_MAX_EXCEEDED
0x80042529L
1つのボリュームあたり32ディスクを超えることはできません。
VDS_E_VOLUME_TOO_SMALL
0x8004242CL
ボリュームサイズが小さすぎます。

解説(Remarks)

注意 このメソッドは、リムーバブルディスク上にボリュームを作成するために使用することはできません。
呼び出し元はこのメソッドを使用して、現在のパック内に新しいシンプル、スパン、ストライプ、ミラー、またはパリティ付きストライプ (RAID-5) ボリュームを作成します。シンプルボリュームとスパンボリュームは、プレックスとメンバーをそれぞれ1つだけ持ちます。 ストライプボリュームと RAID-5 ボリュームは、複数の列とメンバーを持ちます。ミラーボリュームは複数のプレックスで構成されます。

ベーシックディスクにはシンプルボリュームのみを含めることができます。ダイナミックディスクには、オペレーティングシステムがバインド操作をサポートしている限り、 すべての種類のボリュームを含めることができます。サーバー以外のプラットフォームでは、フォールトトレラントな バインド操作はサポートされません。新しく作成されたボリュームには、いずれもドライブ文字が割り当てられていません。

ベーシックディスク上では、このメソッドはプライマリパーティションを作成します。ディスク上に既に3つのプライマリパーティションが存在する場合は、ディスク上に残っている最大の連続した空き領域エクステントをカバーする拡張パーティションを作成し、その拡張パーティション内に論理ドライブを作成します。

1つのディスクが、同じボリュームの複数のプレックスを構成することはできません。ただし、1つのディスクが 複数のボリュームを構成することはできます。シンプルボリュームは VDS_INPUT_DISK 構造体を1つだけ持ちますが、スパン、ストライプ、 ミラー、および RAID-5 ボリュームは、構成する各ディスクごとに1つの構造体を持ちます。

VDS_INPUT_DISK 構造体で指定するディスクのサイズは、 ディスク全体でも、ディスクの一部でもかまいません。2つのディスクでミラーボリュームを構成する場合、VDS は最も小さいディスクを使用して ミラーのサイズを計算します。(実際のオフセット、長さ、および特定の入力ディスクに割り当てられるディスクエクステントの数は、 プロバイダーのポリシーによって決まります。) 作成されたボリュームの正確なサイズを判別するには、 IVdsPack::QueryVolumes メソッドを 使用してください。

省略可能なアラインメントパラメーターを指定して論理ボリュームを作成するには、IVdsPack2::CreateVolume2 メソッドを使用するか、HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\vds\Alignment レジストリキーを使用してアラインメント値をバイト単位で指定します。

Windows 7、Windows Server 2008 R2、Windows Vista、および Windows Server 2008: ベーシックディスク上では、CreateVolume メソッドは HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\vds\Alignment レジストリキーを無視します。これは既知の問題であり、対応が進められています。回避策として、IVdsAdvancedDisk::CreatePartition メソッドまたは IVdsCreatePartitionEx::CreatePartitionEx メソッドを使用して、ベーシックディスク上に正しくアラインメントされるようにパーティションを作成してください。

ダイナミックパーティションおよびボリュームは、次のレジストリキーの下にある値を使用してアラインメントされます。

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\vds\Alignment

既定のアラインメントは、ディスクが4 GB以上の場合は1 MB、ディスクが4 GB未満の場合は64 KBです。

実装者は、呼び出しが非同期操作を開始するかどうかにかかわらず、このメソッドで IVdsAsync インターフェイスへのポインターを返す必要があります。

vtbl 8 HRESULT AddDisk(GUID DiskId, VDS_PARTITION_STYLE PartitionStyle, BOOL bAsHotSpare)

オンラインパックにディスクを追加します。

DiskIdGUIDinディスクの GUID です。
PartitionStyleVDS_PARTITION_STYLEinスタイルは MBR または GPT のいずれかです。VDS_PARTITION_STYLE 列挙型を参照してください。
bAsHotSpareBOOLintrue の場合、VDS はディスクをホットスペアとして使用できます。それ以外の場合、ディスクはこの操作には使用できません。ホットスペアをサポートするのはハードウェアプロバイダーのみです。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
ディスクが正常に追加されました。
VDS_E_NOT_AN_UNALLOCATED_DISK
0x80042418L
ディスクが raw です。
VDS_E_OPERATION_DENIED
0x8004240AL
追加しようとしているディスクはクリーニング中です。
VDS_E_PROVIDER_FAILURE
0x80042442L
操作中にプロバイダーの障害が発生しました。
VDS_E_NOT_SUPPORTED
0x80042400L
ベーシックパックへの2つ目のディスクの追加はサポートされていません。
VDS_E_PACK_OFFLINE
0x80042444L
対象のパックにアクセスできません。
VDS_E_OBJECT_NOT_FOUND
0x80042405L
ディスクが見つかりません。
VDS_E_DMADMIN_METHOD_CALL_FAILED
0x80042420L
論理ディスクマネージャー (LDM) サービスがメソッドの完了に失敗しました。
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
ダイナミックプロバイダーのキャッシュが破損しています。

解説(Remarks)

VDS がこのメソッドを実装します。

このメソッドは、raw ディスク (パーティションが定義されていないディスク) を初期化し、パックに追加します。このメソッドが呼び出される前は、raw ディスクは VDS サービスによって所有されています。このメソッドから戻った後は、ディスクはベーシックプロバイダーによって所有されます。

このメソッドの効果を元に戻す (つまり、パーティション形式を削除して、ディスクを VDS サービスが所有する raw ディスクに戻す) には、IVdsAdvancedDisk::Clean メソッドを使用します。

既存のディスクのパーティションを再定義するために AddDisk を使用することはできません。

GPT ディスクをベーシックパックに追加すると、 操作によってディスク上に MSR パーティションが自動的に作成されます。WinPE オペレーティングシステムを実行しているデバイスは例外です。これは、管理者がディスク上に ESP パーティションを作成することを望む場合があるためです。ESP パーティションが存在する場合は、ディスク上の最初のパーティションである必要があります。

ディスクをダイナミックパックに追加する場合、操作は MSR パーティションを作成しません。

vtbl 9 HRESULT MigrateDisks(GUID* pDiskArray, INT lNumberOfDisks, GUID TargetPack, BOOL bForce, BOOL bQueryOnly, HRESULT* pResults, BOOL* pbRebootNeeded)

ディスクのセットを、あるパックから別のパックへ移行します。

pDiskArrayGUID*inGUID の配列へのポインターです。ディスク1つにつき1つの GUID を指定します。
lNumberOfDisksINTin移行するディスクの数です。
TargetPackGUIDinパックオブジェクトの GUID です。
bForceBOOLinこのパラメーターが TRUE に設定されている場合、VDS はこのメソッドからのすべてのエラーを無視し、無条件にディスクの移行を試みます。FALSE に設定されている場合、 操作は続行されません。場合によっては、強制的な移行によってデータが失われることがあります。
bQueryOnlyBOOLinこのパラメーターが TRUE に設定されている場合、移行は実行されません。FALSE に設定されている場合、操作が続行されます。
pResultsHRESULT*out

呼び出し元が割り当てた HRESULT 値の配列のアドレスです。 配列の要素数は lNumberOfDisks です。

ディスクが移行可能である場合、または正常に移行された場合、対応する配列要素は S_OK を受け取ります。それ以外の場合は、プロバイダーが返した警告コードまたはエラーコードを受け取ります。追加の 結果コードの一覧については、「戻り値」を参照してください。

pbRebootNeededBOOL*outこのパラメーターが TRUE に設定されている場合、操作を完了するにはコンピューターを再起動する必要があります。FALSE に設定されている場合、操作は再起動なしで完了します。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
移行が正常に完了しました。
S_FALSE
少なくとも1つのディスクが変換できないか、警告付きで変換できます。
VDS_E_DISK_NOT_ONLINE
0x8004244BL
いずれかのディスクが使用できません。
VDS_E_IMPORT_SET_INCOMPLETE
0x80042451L
外部パック内のディスクの一部のみをインポートしようとしました。

次の警告およびエラーが pResults を通じて返されることがあります。

リターンコード/値 説明
VDS_S_BOOT_PARTITION_NUMBER_CHANGE
0x00042436L
移行操作の結果として、ブートパーティションのパーティション番号が変更されました。
VDS_E_NO_FREE_SPACE
0x80042437L
選択されたディスクには、操作を完了するのに十分な空き領域がありません。
VDS_E_ACTIVE_PARTITION
0x80042438L
選択されたディスク上でアクティブパーティションが検出されましたが、それはアクティブなオペレーティングシステムのブートに使用される アクティブパーティションではありません。
VDS_E_PARTITION_OF_UNKNOWN_TYPE
0x80042439L
パーティション情報を読み取ることができません。
VDS_E_LEGACY_VOLUME_FORMAT
0x8004243AL
選択されたディスク上で、不明な種類のパーティションが検出されました。
VDS_E_NON_CONTIGUOUS_DATA_PARTITIONS
0x8004243BL
選択された GPT ディスクには、1つ以上のベーシックデータパーティションの前後に挟まれた、非ベーシックデータパーティションが 含まれています。
VDS_E_MIGRATE_OPEN_VOLUME
0x8004243CL
選択されたディスク上のボリュームを開くことができません。

解説(Remarks)

VDS がこのメソッドを実装します。

1つのパックが持てるベーシックディスクは1つだけです。そのため、ベーシックパックとダイナミックパックの間で移行できるのは、一度に1つのディスクだけです。

ベーシックディスクをダイナミックディスク形式に変換する際に、ディスクの末尾に LDM データベース用の 十分な空き領域がない場合は、この操作を強制的に実行する必要があります。bForce パラメーターを true に設定し、空き領域の制限にかかわらず 操作を強制してください。同様に、OEM パーティションが MBR ディスクの中央にあり、その両側に空き領域 またはデータボリュームがある場合も同様です。

ダイナミックディスクをダイナミックパックに移行した後は、IVdsPack::GetProperties メソッドを使用して、移行元と移行先のどちらのパックが現在オンラインパックであるかを判別する必要があります。

MigrateDisks メソッドを使用して外部ディスクをパックに追加する方法については、「パックへの外部ディスクの追加」を参照してください。

vtbl 10 HRESULT ReplaceDisk(GUID OldDiskId, GUID NewDiskId, IVdsAsync** ppAsync)

サポートされていません。このメソッドは将来の使用のために予約されています。(IVdsPack.ReplaceDisk)

OldDiskIdGUIDin古いディスクの GUID です。
NewDiskIdGUIDin新しいディスクの GUID です。
ppAsyncIVdsAsync**outIVdsAsync インターフェイスポインターの アドレスで、VDS が戻り時に初期化します。呼び出し元はインターフェイスを解放する必要があります。このインターフェイスを使用して、操作のキャンセル、完了の待機、 または状態の照会を行います。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
ディスクの置換が正常に完了しました。
VDS_E_NOT_SUPPORTED
0x80042400L
このメソッドは、このリリースではサポートされていません。

解説(Remarks)

呼び出し元は、このメソッドを、メディアの移行 (古いディスクを新しいディスクに置き換えること)、または欠落したメンバーや障害が発生したメンバーを含むフォールトトレラントセットを修復する際に使用できます。特に、 ホットスペアを実装していないプロバイダーの場合に使用します。

新しいディスクは古いディスクと同じパックに存在する必要があり、データを含んでいてはなりません。パーティションスタイルは 間違っていてもかまいません。置換が成功した場合、古いディスクはパーティションスタイルを保持しますが、 有効なボリュームは持ちません。

実装者は、呼び出しが非同期操作を開始するかどうかにかかわらず、このメソッドで IVdsAsync インターフェイスへのポインターを返す必要があります。プロバイダーがホットスペアを実装していない場合は、障害が発生したメンバーの シナリオをサポートする必要があります。つまり、呼び出し元が ReplaceDisk メソッドを呼び出した後、公開されている フォールトトレラントボリュームの同期を再度開始する必要があります。

vtbl 11 HRESULT RemoveMissingDisk(GUID DiskId)

パックから欠落しているディスクを削除します。このメソッドはソフトウェアプロバイダーオブジェクトにのみ適用されます。

DiskIdGUIDin欠落しているディスクの VDS_OBJECT_ID です。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
ディスクのすべての詳細が正常に削除されました。
VDS_E_NOT_SUPPORTED
0x80042400L
DiskId はベーシックディスクです。

解説(Remarks)

このメソッドはダイナミックディスクに対してのみ使用してください。

vtbl 12 HRESULT Recover(IVdsAsync** ppAsync)

障害が発生しつつある、または障害が発生したパックを、可能であれば正常な状態に戻します。このメソッドはダイナミックパックに対してのみサポートされます。

ppAsyncIVdsAsync**outIVdsAsync インターフェイスポインターのアドレスで、VDS が 戻り時に初期化します。呼び出し元はインターフェイスを解放する必要があります。このインターフェイスを使用して、操作のキャンセル、完了の待機、または状態の 照会を行います。

戻り値

このメソッドは、E_INVALIDARGE_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返すこともあります。エラーは VDS 自体、または使用中の基盤となる VDS プロバイダー から発生する可能性があります。戻り値には次のものがあります。

リターンコード/値 説明
S_OK
回復が正常に完了しました。
VDS_E_DMADMIN_METHOD_CALL_FAILED
0x80042420L
論理ディスクマネージャー (LDM) サービスのメソッドが失敗しました。

解説(Remarks)

このメソッドは、パックおよびパックに関連するすべてのオブジェクトを正常な状態に戻そうとしますが、 常に成功するとは限りません。成功した場合、Recover メソッドは パック内のすべてのオブジェクトの状態を最新の情報に更新します。また、プロバイダーを、ディスクやその他のオブジェクトの基盤となる状態と 同期させます。

実装者は、呼び出しが非同期操作を開始するかどうかにかかわらず、このメソッドで IVdsAsync インターフェイスへのポインターを返す必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IVdsPack "{3B69D7F5-9D94-4648-91CA-79939BA263BF}"
#usecom global IVdsPack IID_IVdsPack "{}"
#comfunc global IVdsPack_GetProperties      3 var
#comfunc global IVdsPack_GetProvider        4 sptr
#comfunc global IVdsPack_QueryVolumes       5 sptr
#comfunc global IVdsPack_QueryDisks         6 sptr
#comfunc global IVdsPack_CreateVolume       7 int,var,int,int,sptr
#comfunc global IVdsPack_AddDisk            8 int,int,int
#comfunc global IVdsPack_MigrateDisks       9 var,int,int,int,int,var,var
#comfunc global IVdsPack_ReplaceDisk        10 int,int,sptr
#comfunc global IVdsPack_RemoveMissingDisk  11 int
#comfunc global IVdsPack_Recover            12 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。