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

Статья
08/25/2023

Загружает библиотеку DLL ресурса, возвращая структуру, содержащую таблицу функций и номер версии. Тип PSTARTUP_ROUTINE определяет указатель на эту функцию.

Синтаксис

PSTARTUP_ROUTINE PstartupRoutine;

DWORD PstartupRoutine(
  [in]  LPCWSTR ResourceType,
  [in]  DWORD MinVersionSupported,
  [in]  DWORD MaxVersionSupported,
  [in]  PSET_RESOURCE_STATUS_ROUTINE SetResourceStatus,
  [in]  PLOG_EVENT_ROUTINE LogEvent,
  [out] PCLRES_FUNCTION_TABLE *FunctionTable
)
{...}

Параметры

[in] ResourceType

Тип запускаемого ресурса.

[in] MinVersionSupported

Минимальная версия API ресурсов , поддерживаемая службой кластеров.

[in] MaxVersionSupported

Максимальная версия API ресурсов, поддерживаемая службой кластеров.

[in] SetResourceStatus

Указатель на функцию обратного вызова, которую библиотека ресурсов должна вызвать для обновления своего состояния после возврата ERROR_IO_PENDING из сети или автономной среды. Дополнительные сведения см. в разделе SetResourceStatus.

[in] LogEvent

Указатель на функцию обратного вызова, которую библиотека ресурсов должна вызывать для создания отчетов о событиях для ресурса. Дополнительные сведения см. в разделе LogEvent.

[out] FunctionTable

Указатель на структуру CLRES_FUNCTION_TABLE , которая описывает версию API ресурсов и конкретные имена точек входа.

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

Возвращаемый код или значение	Описание
ERROR_SUCCESS 0	Запрос выполнен успешно.
ERROR_REVISION_MISMATCH 1306 (0x51A)	Библиотека DLL ресурса не поддерживает версию, которая попадает в диапазон, определенный параметрами MinVersionSupported и MaxVersionSupported .

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

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

В настоящее время поддерживается только API ресурсов версии 1.0.

Если ресурс поддерживает несколько версий API ресурсов, верните таблицу функций для последней версии. Номер версии должен быть меньше или равен параметру MaxVersionSupported . Если версия таблицы функций, на которую указывает параметр FunctionTable , не находится в пределах диапазона, ресурс не может быть успешно загружен.

Дополнительные сведения см. в разделе Реализация запуска.

Примеры

См . раздел Реализация запуска.

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
Целевая платформа	Windows
Header	resapi.h

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

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

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