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

Статья
03/13/2024

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

Синтаксис

POFFLINE_V2_ROUTINE PofflineV2Routine;

DWORD PofflineV2Routine(
  [in]           RESID Resource,
  [in, optional] LPCWSTR DestinationNodeName,
  [in]           DWORD OfflineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

Параметры

[in] Resource

Идентификатор ресурса для ресурса, который будет отключен.

[in, optional] DestinationNodeName

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

[in] OfflineFlags

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

CLUS_RESDLL_OFFLINE_IGNORE_RESOURCE_STATUS (0x00000001)

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

CLUS_RESDLL_OFFLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000002)

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

CLUS_RESDLL_OFFLINE_QUEUE_ENABLED (0x00000004)

Помещает операцию в очередь, если она задерживается библиотекой DLL ресурса, а затем повторяйте операцию, пока она не завершится или не будет отменена клиентом.

CLUS_RESDLL_OFFLINE_RETURNING_TO_SOURCE_NODE_BECAUSE_OF_ERROR (0x00000008)

Укажите, что ресурс столкнулся с ошибкой и возвращается на исходный узел.

CLUS_RESDLL_OFFLINE_DUE_TO_EMBEDDED_FAILURE (0x00000010)

Укажите, что произошел сбой внедрения.

CLUS_RESDLL_OFFLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000020)

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

Windows Server 2012. Это значение не поддерживается до Windows Server 2012 R2.

CLUS_RESDLL_OFFLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000040)

Не обновляйте постоянное состояние ресурса.

Windows Server 2012 R2 и Windows Server 2012. Это значение не поддерживается до Windows Server 2016.

[in, optional] InBuffer

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

[in] InBufferSize

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

[in] Reserved

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

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

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

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

Требования

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

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

Функции точки входа в библиотеку ресурсов DLL

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