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

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

  • Статья

Выполняет или игнорирует пакет, созданный функцией ClusterRegCreateBatch .

Синтаксис

LONG ClusterRegCloseBatch(
  [in]            HREGBATCH hRegBatch,
  [in]            BOOL      bCommit,
  [out, optional] INT       *failedCommandNumber
);

Параметры

[in] hRegBatch

Дескриптор раздела реестра кластера, открытый ClusterRegCreateBatch. После завершения ClusterRegCloseBatch этот дескриптор больше недействителен, и связанная с ним память освобождается.

[in] bCommit

Если этот параметр принимает значение true, пакет отправляется для выполнения на сервер кластера.

[out, optional] failedCommandNumber

Если выполнение пакета не выполнено успешно, номер команды, которая завершилась сбоем, возвращается в виде аргумента failedCommandNumber . Первая команда в пакете имеет число 0, вторая — 1 и т. д.

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

Функция возвращает один из следующих кодов системных ошибок.

Возвращаемый код или значение Описание
ERROR_SUCCESS
0
 Операция выполнена успешно.
ERROR_INVALID_HANDLE
6
 Недопустимый дескриптор. Это значение возвращается, если параметр hRegBatch имеет значение NULL.

Комментарии

Если до выполнения какой-либо команды произошел сбой, параметр failedCommandNumber имеет значение –1.

Тип PCLUSTER_REG_CLOSE_BATCH определяет указатель на эту функцию.

Требования

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

См. также раздел

Функции доступа к реестру кластера

ClusterRegBatchAddCommand

ClusterRegCloseBatchEx

ClusterRegCreateBatch