IVssFileShareSnapshotProvider::Query メソッド (vsprov.h)

  • [アーティクル]

アプリケーション サーバーで使用できるすべてのファイル共有スナップショットの VSS_SNAPSHOT_PROP 構造体の列挙体を取得します。

構文

HRESULT Query(
  [in]  VSS_ID          QueriedObjectId,
  [in]  VSS_OBJECT_TYPE eQueriedObjectType,
  [in]  VSS_OBJECT_TYPE eReturnedObjectsType,
  [out] IVssEnumObject  **ppEnum
);

パラメーター

[in] QueriedObjectId

システムで使用するために予約されています。 このパラメーターの値はGUID_NULLする必要があります。

[in] eQueriedObjectType

システムで使用するために予約されています。 このパラメーターの値はVSS_OBJECT_NONEする必要があります。

[in] eReturnedObjectsType

システムで使用するために予約されています。 このパラメーターの値はVSS_OBJECT_SNAPSHOTする必要があります。

[out] ppEnum

返されるときに初期化される IVssEnumObject インターフェイス ポインターのアドレス。 呼び出し元はインターフェイスを解放する必要があります。 このパラメーターは必須であり、null にすることはできません。

戻り値

このメソッドの有効なリターン コードを次に示します。

値 説明
S_OK
 クエリ操作が成功しました。
E_ACCESSDENIED
 呼び出し元に十分なバックアップ特権がないか、管理者ではありません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_PROVIDER_VETO
 プロバイダー エラー。 プロバイダーは、イベント ログにエラーを記録しました。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

解説

このメソッドは、通常、要求者によって生成されたスナップショットクエリ操作に応答して呼び出されます。

ppEnum パラメーターが返される IVssEnumObject インターフェイスで IVssEnumObject::Next メソッドを呼び出すと、シャドウ コピーごとにVSS_SNAPSHOT_PROP構造を含むVSS_OBJECT_PROP構造体が返されます。

要件

   
サポートされている最小のクライアント Windows 8.1 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vsprov.h
Library VssApi.lib

関連項目

IVssFileShareSnapshotProvider