функция обратного вызова PONLINE_V2_ROUTINE (resapi.h)

Статья
08/25/2023

Помечает ресурс как доступный для использования. Тип PONLINE_V2_ROUTINE определяет указатель на эту функцию.

Синтаксис

PONLINE_V2_ROUTINE PonlineV2Routine;

DWORD PonlineV2Routine(
  [in]           RESID Resource,
  [out]          LPHANDLE EventHandle,
  [in]           DWORD OnlineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

Параметры

[in] Resource

Идентификатор ресурса, который будет доступен.

[out] EventHandle

На входных данных EventHandle имеет значение NULL. В выходных данных EventHandle содержит дескриптор объекта синхронизации без сигнала. Библиотека DLL ресурса может сообщить об этом дескрипторе в любое время, чтобы сообщить монитору ресурсов о сбое ресурса. Для выходных данных EventHandle также можно задать значение NULL, что означает, что ресурс не поддерживает асинхронные уведомления о событиях.

[in] OnlineFlags

Битовая маска флагов, определяющих параметры для этой операции. Для этого параметра можно задать одно или несколько из следующих значений:

CLUS_RESDLL_ONLINE_RECOVER_MONITOR_STATE (0x00000001)

Отслеживайте состояние ресурса, если ресурс восстанавливается после ошибки.

CLUS_RESDLL_ONLINE_IGNORE_RESOURCE_STATUS (0x00000002)

Выполните операцию, даже если ресурс указывает, что он должен быть заблокирован.

CLUS_RESDLL_ONLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000004)

Если ресурс испытывает ошибку, верните его в исходный узел.

CLUS_RESDLL_ONLINE_RESTORE_ONLINE_STATE (0x00000008)

Задайте для ресурса состояние "В сети".

CLUS_RESDLL_ONLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000010)

Выполните операцию, даже если возникла ошибка сети.

[in, optional] InBuffer

Указатель на буфер, содержащий данные для операции; В противном случае значение NULL , если операция не требует данных.

[in] InBufferSize

Размер параметра InBuffer в байтах.

[in] Reserved

Зарезервировано.

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

Возвращаемый код или значение	Описание
ERROR_SUCCESS 0	Операция выполнена успешно, а ресурс подключен к сети.
ERROR_RESOURCE_NOT_AVAILABLE 5006 (0x138E)	Ресурс был арбитражирован с некоторыми другими системами, и одна из других систем выиграла арбитраж. Это значение возвращают только ресурсы, поддерживающие кворум .
ERROR_IO_PENDING 997 (0x3E5)	Запрос находится в состоянии ожидания, и для обработки онлайн-запроса активирован поток.

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

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2012 R2
Целевая платформа	Windows
Header	resapi.h

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

Функции Entry-Point dll ресурсов

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