次の方法で共有

IVssExamineWriterMetadataEx::GetIdentityEx メソッド (vsbackup.h)

  • [アーティクル]

GetIdentityEx メソッドは、ライター インスタンス名と、特定のライター インスタンスに関するその他の基本情報を取得します。

構文

HRESULT GetIdentityEx(
  [out] VSS_ID          *pidInstance,
  [out] VSS_ID          *pidWriter,
  [out] BSTR            *pbstrWriterName,
  [out] BSTR            *pbstrInstanceName,
  [out] VSS_USAGE_TYPE  *pUsage,
  [out] VSS_SOURCE_TYPE *pSource
);

パラメーター

[out] pidInstance

ライター インスタンスのグローバル一意識別子 (GUID)。

[out] pidWriter

ライター クラスの GUID。

[out] pbstrWriterName

ライターの名前を指定する文字列へのポインター。

[out] pbstrInstanceName

ライター インスタンス名を指定する文字列へのポインター。

[out] pUsage

ライターによって管理されるデータがホスト システムでどのように使用されるかを示す VSS_USAGE_TYPE列挙値 へのポインター。

[out] pSource

ライターによって管理 される データの種類を示すVSS_SOURCE_TYPE列挙値へのポインター。

戻り値

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

値 意味
S_OK
 ID 情報が正常に返されました。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_INVALID_XML_DOCUMENT
 XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。

注釈

このメソッドは、pbstrInstanceName パラメーターを除き、IVssExamineWriterMetadata::GetIdentity メソッドと同じです。

pbstrInstanceName パラメーターは、ライターの初期化時に CVssWriter::Initialize によって指定されたライター インスタンス名です。

ライター インスタンス名は、1 台のコンピューターで同じライター クラス ID を持つ複数のライター インスタンスの実行をサポートするライターに役立ちます。 ライター インスタンス名を使用して、特定のインスタンスを識別できます。 したがって、ライターはライター クラス内でインスタンス名を一意にする必要があります。 また、ライター インスタンス名はバックアップと復元の間に保持されることが想定されており、VSS は複数インスタンス ライターを正しく復元するために使用されます。

呼び出し元は、SysFreeString を呼び出すことによって、pbstrWriterName パラメーターと pbstrInstanceName パラメーターによって保持されているメモリを解放する必要があります。

IVssExamineWriterMetadataEx インターフェイスは、格納されているライター状態情報 (CreateVssExamineWriterMetadata の呼び出しによって作成) から取得される場合があります。 この場合、次のことが当てはまります。

  • pidInstance は、ライブ ライターの観点から何も意味しない可能性があります。
  • pidWriter がライブ ライターのライター クラスと一致しない場合、リクエスターはそのライターのコンポーネントを使用しないでください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008、Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む)
Library VssApi.lib

こちらもご覧ください

CVssWriter::Initialize

IVssExamineWriterMetadataEx