CLUS_STARTING_PARAMS

ノードによる クラスター サービスの開始が、クラスターの形成と参加のどちらを試みるものか、およびそのノードがこのバージョンのクラスター サービスを以前に開始しようとしたことがあるかどうかを示します。 リソース DLL は、CLUSCTL_RESOURCE_TYPE_STARTING_PHASE1 および CLUSCTL_RESOURCE_TYPE_STARTING_PHASE2 制御コードとともに CLUS_STARTING_PARAMS 構造体を受け取ります。

CLUS_STARTING_PARAMS 構造体により、リソース DLL は開始時の状況に応じて CLUSCTL_RESOURCE_TYPE_STARTING_PHASE1 および CLUSCTL_RESOURCE_TYPE_STARTING_PHASE2 制御コードに応答できます。たとえば、DLL はクラスターの形成時に特別な初期化処理を実行し、参加に対しては別の一連の操作を実行することができます。

例

次の例は、ResourceTypeControl の簡略化した実装を示しています。詳細については、ResourceTypeControl の実装 を参照してください。

const LPWSTR g_MY_RESOURCE_TYPE_NAME[] =
{
    L"MyType_0",
    L"MyType_1",
    L"MyType_2",
    L"MyType_3"
};

DWORD WINAPI MyDllResourceTypeControl(
    IN LPCWSTR ResourceTypeName,
    IN DWORD ControlCode,
    IN PVOID InBuffer,
    IN DWORD InBufferSize,
    OUT PVOID OutBuffer,
    IN DWORD OutBufferSize,
    OUT LPDWORD BytesReturned
)
{
    DWORD status;
    PCLUS_STARTING_PARAMS pStart;

    switch ( ControlCode )
    {
        case CLUSCTL_RESOURCE_TYPE_STARTING_PHASE1:

            if( lstrcmpi( ResourceTypeName, g_MY_RESOURCE_TYPE_NAME[2] ) == 0 )
            {
                pStart = (PCLUS_STARTING_PARAMS) InBuffer;
                if( ( pStart->bForm == TRUE ) && 
                    ( pStart->bFirst == FALSE ) )
                {
                //  Hypothetical initialization code for resource type "MyType_2"
                //  Fires only when the cluster forms, but not for first-time launches of the Cluster service.
                }
            }
            else
            {
                status = ERROR_INVALID_FUNCTION;
            }

            break;

        case CLUSCTL_RESOURCE_TYPE_STARTING_PHASE2:

            pStart = (PCLUS_STARTING_PARAMS) InBuffer;
            if( pStart->bFirst == TRUE )
            {
            //  Hypothetical verification code for all resource types supported by the DLL
            //  Fires for first-time launches of the Cluster service
            }
            else
            {
                status = ERROR_INVALID_FUNCTION;
            }

            break;

    //  case ( Other control codes )....
    //      ...
    //      break;

        default:
            status = ERROR_INVALID_FUNCTION;
            break;

    }
    // end switch

    return( status );

}
// MyDllResourceTypeControl