Функция CancelClusterGroupOperation (clusapi.h)

Статья
08/22/2023

Позволяет клиенту отменить операцию MoveClusterGroup или MoveClusterGroupEx , ожидающую для группы. Затем группа возвращается в постоянное состояние.

Синтаксис

DWORD CancelClusterGroupOperation(
  [in] HGROUP hGroup,
  [in] DWORD  dwCancelFlags_RESERVED
);

Параметры

[in] hGroup

Дескриптор группы кластера.

[in] dwCancelFlags_RESERVED

Этот параметр зарезервирован для использования в будущем и должен иметь нулевое значение.

Возвращаемое значение

CancelClusterGroupOperation возвращает ERROR_SUCCESS , если операция перемещения в группе была успешно отменена.

CancelClusterGroupOperation возвращает ERROR_IO_PENDING , если отмена операции перемещения выполняется.

CancelClusterGroupOperation возвращает другой ненулевой код ошибки, если произошел сбой при отмене операции группы перемещения в указанной группе.

CancelClusterGroupOperation пытается отменить ожидающую операцию перемещения в группе кластера, которая была выполнена с помощью вызова MoveClusterGroup или MoveClusterGroupEx , который вернул ERROR_IO_PENDING и все еще выполняется. Вызов пытается отменить отложенную операцию перемещения и перевести группу в постоянное состояние.

Примеры

#include "stdafx.h"
#include <windows.h>
#include <stdio.h>
#include <ClusAPI.h>


#define DemoResDllTypeName L"dummy"
#define DemoGroupName L"DemoGroup"

int __cdecl main( void )
{
    HCLUSTER hCluster= NULL;
    HGROUP hGroup = NULL;
    DWORD error = 0;

    hCluster = OpenCluster( NULL );
    if ( hCluster == NULL )
    {
        error = GetLastError();
        wprintf( L"Failed to open cluster: 0x%x\n", error );
        goto Cleanup;
    }

    hGroup = OpenClusterGroup( hCluster, DemoGroupName );
    if ( hGroup == NULL )
    {
        error = GetLastError();
        wprintf( L"Failed to open cluster group " DemoGroupName L": 0x%x\n", error );
        goto Cleanup;
    }


    // Cancel Move Group example
    error = MoveClusterGroupEx( hGroup,
                                NULL,
                                CLUSAPI_GROUP_MOVE_RETURN_TO_SOURCE_NODE_ON_ERROR | CLUSAPI_GROUP_MOVE_IGNORE_RESOURCE_STATUS,
                                NULL,
                                0);

    if ( error == ERROR_IO_PENDING  )
    {
        wprintf( L"Group move pending" DemoGroupName L": 0x%x\n", error );
        error = ERROR_SUCCESS;

        // Issuing cancel to the move operation
        error = CancelClusterGroupOperation(hGroup, 0);
        if ( error == ERROR_IO_PENDING  || error == ERROR_SUCCESS )
        {
            // the cancel was registered successfully
            wprintf( L"Cancel issued for move operation for the group " DemoGroupName L"\n" );
        }
        else
        {
            wprintf( L"Failed to Cancel move operation for the group " DemoGroupName L": 0x%x\n" );
        }
    }
    else if ( error != ERROR_SUCCESS)
    {
        wprintf( L"Failed to move group" DemoGroupName L": 0x%x\n", error );
    }
    else 
    {
        wprintf( L"Group move completed" DemoGroupName L": 0x%x\n");
    }


Cleanup:

    if ( hGroup != NULL )
    {
        CloseClusterGroup( hGroup );
        hGroup = NULL;
    }
    if ( hCluster != NULL )
    {
        CloseCluster( hCluster );
        hCluster = NULL;
    }

    return (int)error;
}

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	clusapi.h
Библиотека	ClusAPI.lib
DLL	ClusAPI.dll

Поделиться через