ILayoutStorage::BeginMonitor メソッド (objidl.h)
BeginMonitor メソッドは、読み込み操作が開始されたときに監視を開始するために使用されます。 操作が完了したら、アプリケーションは ILayoutStorage::EndMonitor を呼び出す必要があります。
構文
HRESULT BeginMonitor();
戻り値
このメソッドは、標準の戻り値E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG、およびE_FAILをサポートします。
| リターン コード | 説明 |
|---|---|
| STG_E_INUSE | ILayoutStorage が既に監視されている間に BeginMonitor が呼び出されました。 |
注釈
通常、アプリケーションは、実際の読み込みが開始される前に BeginMonitor を呼び出します。 このメソッドが呼び出されると、複合ファイルの実装では、ファイル ストレージとストリームに対して実行されるすべての操作が目的のアクセス パターンの一部と見なされます。 結果は、 ILayoutStorage::LayoutScript を呼び出すことによって明示的に作成されたようなレイアウト スクリプトになります。
アプリケーションでは通常、監視を使用して埋め込みオブジェクトのアクセス パターンを取得します。 監視により、既存のアプリケーションを起動し、アクセス パターンを監視する汎用レイアウト ツールも可能になります。
ILayoutStorage::EndMonitor の呼び出しは監視を終了します。 BeginMonitor と EndMonitor への複数の呼び出しが許可されています。 監視は、 ILayoutStorage::LayoutScript の呼び出しと混合することもできます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | objidl.h |
| Library | Uuid.lib |
| [DLL] | Ole32.dll |