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

Статья
02/23/2024

Создает или изменяет порт уведомлений. Сведения о портах уведомлений см. в разделе Получение событий кластера.

Синтаксис

HCHANGE CreateClusterNotifyPortV2(
  [in] HCHANGE                hChange,
  [in] HCLUSTER               hCluster,
  [in] NOTIFY_FILTER_AND_TYPE *Filters,
  [in] DWORD                  dwFilterCount,
  [in] DWORD_PTR              dwNotifyKey
);

Параметры

[in] hChange

Дескриптор порта уведомления или INVALID_HANDLE_VALUE, указывающий, что необходимо создать новый дескриптор. Если параметр hChange является существующим дескриптором, события, указанные в параметре dwFilter , добавляются в порт уведомлений.

[in] hCluster

Дескриптор кластера , связанный с портом уведомлений, который определяется параметром hChange или INVALID_HANDLE_VALUE, указывающий, что порт уведомлений не должен быть связан с кластером. Если параметру hChange не присвоено значение INVALID_HANDLE_VALUE, параметру hCluster нельзя задать значение INVALID_HANDLE_VALUE.

[in] Filters

Указатель на структуру NOTIFY_FILTER_AND_TYPE , указывающую тип уведомлений, которые может принимать порт.

[in] dwFilterCount

Количество фильтров, заданных параметром Filters .

[in] dwNotifyKey

Указанное пользователем значение, которое необходимо связать с получением уведомлений из порта уведомлений. Параметр dwNotifyKey возвращается из GetClusterNotifyV2 при возникновении события одного из типов, указанных в разделе Фильтры .

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

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

Если операция завершается сбоем, функция возвращает значение NULL. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Требования

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

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

Функция управления отказоустойчивости кластеров

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