IVssWMDependency::GetComponentName メソッド (vswriter.h)

  • [アーティクル]

GetComponentName メソッドは、明示的なライター コンポーネント依存関係で現在のコンポーネントが依存するコンポーネントの名前を取得します。

構文

HRESULT GetComponentName(
  BSTR *pbstrComponentName
);

パラメーター

pbstrComponentName

現在のコンポーネントが依存するコンポーネントの名前を含む NULL で終わるワイド文字列を受け取る呼び出し元割り当て変数のアドレス。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 意味
S_OK
 現在のコンポーネントが依存しているコンポーネントの名前が正常に返されました。
S_FALSE
 現在のコンポーネントが依存するコンポーネントを管理するライターが見つかりません。
E_INVALIDARG
 ポインター pbstrComponentName は 、未割り当てメモリを指します。
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 が使用されます。

注釈

呼び出し元は 、SysFreeString を呼び出して、返された文字列で使用されるメモリを解放する必要があります。

依存関係は、ドキュメント化された依存関係を持つコンポーネントと依存するコンポーネントの間の優先順位を示すものではありません。 依存関係は、コンポーネントと依存するコンポーネントを常に一緒にバックアップまたは復元する必要があることを示しているだけです。

特定のライター クラスの複数のインスタンスを持つことができます。ただし、コンポーネントの論理パスと名前は一意である必要があります。

ライター クラスのインスタンスが複数ある場合は、論理パスとコンポーネント名の情報を使用して、現在のコンポーネントが依存するコンポーネントを管理するインスタンスを識別する必要があります。

要件

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

こちらもご覧ください

IVssWMComponent::GetDependency

IVssWMDependency

IVssWMDependency::GetLogicalPath

IVssWMDependency::GetWriterId