IVssComponentEx

リクエスターのバックアップコンポーネントドキュメントに含まれるコンポーネントに関する情報を調査および変更するための追加メソッドを定義します。

コンポーネントに対する PrepareForBackup の失敗メッセージ文字列を設定します。

このメソッドの有効な戻り値は次のとおりです。

SetPrepareForBackupFailureMsg によって設定された失敗メッセージは、コンポーネント内のすべてのファイルおよびすべてのサブコンポーネントに適用されます。

コンポーネントに対する PostSnapshot の失敗メッセージ文字列を設定します。

このメソッドの有効な戻り値は次のとおりです。

SetPostSnapshotFailureMsg によって設定された失敗メッセージは、コンポーネント内のすべてのファイルおよびすべてのサブコンポーネントに適用されます。

ライターが特定のコンポーネントに対して設定した PrepareForBackup の失敗メッセージ文字列を返します。

このメソッドの有効な戻り値は次のとおりです。

pbstrFailureMsg パラメーターが指す文字列は、SysFreeString 関数を呼び出して解放する責任が呼び出し側にあります。

例

#include <windows.h>
#include "vss.h"
#include "vsmgmt.h"

#define CHKARG_ASSERT(EXPR)  
do
{
    if(! ( EXPR ) )               
    {                       
        assert(FALSE);      
        hr = E_INVALIDARG;  
        goto exit;          
    }                        
}
while ( FALSE, FALSE );

#define  CHK(HR)                
do
{
    hr =  ( HR ) ;                
    if(FAILED(HR))          
    {                       
        hr = HR;            
        goto exit;          
    }                       
}
while ( FALSE, FALSE ); 

STDMETHODIMP CheckAsrBackupErrorMsg
(
      IVssBackupComponents           *pBackup,
      const WCHAR              *pwszWriterName
)
{
    CComPtr<IVssWriterComponentsExt> spWriter;
    CComPtr<IVssComponent>   spComponent;
    CComPtr<IVssComponentEx> spComponentEx;
    UINT    cWriterComponents = 0;
    UINT    iWriterComponent = 0;
    UINT    cComponents = 0;
    UINT    iComponent = 0;
    VSS_ID  idWriter;
    VSS_ID  idInstance;
    CComBSTR bstrFailureMsg;
    HRESULT  hr = S_OK;
    CHKARG_ASSERT( pBackup );
    CHKARG_ASSERT( pwszWriterName );

    CHK( pBackup->GetWriterComponentsCount( &cWriterComponents ) );

    for( iWriterComponent = 0; iWriterComponent < cWriterComponents; iWriterComponent++ )
    {
        spWriter.Release();
        CHK( pBackup->GetWriterComponents( iWriterComponent, &spWriter ) );
        CHK( spWriter->GetWriterInfo(&idInstance, &idWriter) );
        if( idWriter != c_ASRWriterId )
        {
            continue;
        }
        
        CHK( spWriter->GetComponentCount(&cComponents) );
        for( iComponent = 0; iComponent < cComponents; iComponent++ )
        {
            spComponent.Release();
            spComponentEx.Release();
            CHK( spWriter->GetComponent(iComponent, &spComponent) );
            CHK( spComponent->QueryInterface(__uuidof(IVssComponentEx), (void**)&spComponentEx) );

            bstrFailureMsg.Empty();
            CHK( spComponentEx->GetPrepareForBackupFailureMsg(&bstrFailureMsg) );

            if( ::SysStringLen(bstrFailureMsg) != 0 )
            {
                //  Write into the event log.
                Log_SPP_ERROR_WRITER( &ft, __LINE__, pwszWriterName, bstrFailureMsg );

                //  The ASR writer writes the same message to all components. 
                //  Log the message once.
                break;
            }
        }
    }

exit:
    return hr;
}

ライターが特定のコンポーネントに対して設定した PostSnapshot の失敗メッセージ文字列を返します。

このメソッドの有効な戻り値は次のとおりです。

pbstrFailureMsg パラメーターが指す文字列は、SysFreeString 関数を呼び出して解放する責任が呼び出し側にあります。

リクエスターが、レプリケートされたデータストアに対してコンポーネントの復元を authoritative(権限のある)としてマークしているかどうかを判定します。

このメソッドの有効な戻り値は次のとおりです。

ライターは、バックアップスキーママスクに VSS_BS_AUTHORITATIVE_RESTORE フラグを設定することで、authoritative 復元をサポートすることを示します。

詳細については、VSS 復元オプションの設定 を参照してください。

コンポーネントのロールフォワード操作の種類を取得し、部分的なロールフォワード操作の復元ポイントを取得します。

このメソッドの有効な戻り値は次のとおりです。

GetRollForward メソッドは、復元操作中にのみ呼び出すことができます。

GetRollForward の呼び出しが成功した場合、pRollType パラメーターで返される文字列は、SysFreeString 関数を呼び出して解放する責任が呼び出し側にあります。

ライターは、バックアップスキーママスクに VSS_BS_ROLLFORWARD_RESTORE フラグを設定することで、このメソッドをサポートすることを示します。

詳細については、VSS 復元オプションの設定 を参照してください。

復元中のコンポーネントに割り当てられた論理名を取得します。

このメソッドの有効な戻り値は次のとおりです。

GetRestoreName メソッドは、復元操作中にのみ呼び出すことができます。

GetRestoreName の呼び出しが成功した場合、pbstrName パラメーターで返される文字列は、SysFreeString 関数を呼び出して解放する責任が呼び出し側にあります。

ライターは、バックアップスキーママスクに VSS_BS_RESTORE_RENAME フラグを設定することで、このメソッドをサポートすることを示します。

詳細については、VSS 復元オプションの設定 を参照してください。