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


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

Получает пакетное уведомление. После получения пакетного уведомления оно интерпретируется с помощью функции ClusterRegBatchReadCommand . После обработки пакетного уведомления его необходимо закрыть с помощью функции ClusterRegBatchCloseNotification .

Синтаксис

LONG ClusterRegGetBatchNotification(
  [in]  HREGBATCHPORT         hBatchNotify,
  [out] HREGBATCHNOTIFICATION *phBatchNotification
);

Параметры

[in] hBatchNotify

Дескриптор порта пакетного уведомления, открытого ранее с помощью функции ClusterRegCreateBatchNotifyPort .

[out] phBatchNotification

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

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

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

Возвращаемый код или значение Описание
ERROR_SUCCESS
0
Операция выполнена успешно.
ERROR_INVALID_DATA
13 (0xD)
Недопустимые данные.
ERROR_OUTOFMEMORY
14 (0xE)
Недостаточно места в хранилище для завершения этой операции.
ERROR_GEN_FAILURE
31 (0x1F)
Устройство, подключенное к системе, не работает.

Комментарии

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

Уведомление об изменении реестра будут создавать только функции из группы пакетных функций, например ClusterRegBatchAddCommand. Изменение реестра, которое не использует ни одну из команд пакетной функции, не создаст пакетное уведомление.

Требования

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

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

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

ClusterRegBatchCloseNotification

ClusterRegBatchReadCommand

ClusterRegCreateBatchNotifyPort