IVdsService::Refresh メソッド (vds.h)
[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。
ディスク所有権とディスク レイアウト情報を更新します。
構文
HRESULT Refresh();
戻り値
このメソッドは、E_OUTOFMEMORYや VDS 固有の戻り値など、標準の HRESULT 値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
| リターン コード/値 | 説明 |
|---|---|
|
メソッドは正常に完了しました。 |
|
この操作中にエラーが発生しました。 |
|
VDS の初期化に失敗しました。 サービスの初期化が完了する前にアプリケーションがこのメソッドを呼び出すと、初期化が完了するまでメソッドはブロックされます。 初期化が失敗した場合、このエラーが返されます。 |
解説
このメソッドは、ディスク ドライバーに認識されているレイアウトにディスク レイアウトを同期します。 ドライバーがディスクからレイアウトを読み取る必要はありません。 さらに、このメソッドは VDS キャッシュ内のすべてのオブジェクトのビューを更新します。 VDS とプロバイダーは、すべてのオブジェクトに対してクエリを実行し、オブジェクト到着、変更、削除通知を送信して呼び出し元を同期します。 VDS は、通知をトリガーする変更を検出するたびにキャッシュを自動的に更新することに注意してください。 このため、 Refresh を 呼び出すと追加の通知をトリガーできるため、アプリケーションは通知に応答してこのメソッドを呼び出さないでください。 キャッシュ が正しく更新されていないと思われる場合にのみ、更新を呼び出す必要があります。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vds.h |
| Library | Uuid.lib |