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

Открывает ресурс. Тип POPEN_ROUTINE определяет указатель на эту функцию.

Синтаксис

POPEN_ROUTINE PopenRoutine;

RESID PopenRoutine(
  [in] LPCWSTR ResourceName,
  [in] HKEY ResourceKey,
  [in] RESOURCE_HANDLE ResourceHandle
)
{...}

Параметры

[in] ResourceName

Имя открываемого ресурса.

[in] ResourceKey

Ключ базы данных кластера для кластера , включающего ресурс, представленный resourceName.

[in] ResourceHandle

Дескриптор, передаваемый в функцию обратного вызова SetResourceStatus в функции точки входа запуска .

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

Если операция прошла успешно, функция Open возвращает идентификатор ресурса (RESID).

Если операция не была выполнена успешно, функция Open возвращает значение NULL. Вызовите SetLastError , чтобы указать, что произошла ошибка.

Комментарии

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

Никогда не закрывайте дескриптор, представленный параметром ResourceHandle , и не используйте его для любых целей, кроме передачи в монитор ресурсов с помощью функции обратного вызова LogEvent или функции обратного вызова SetResourceStatus .

Эффективные стратегии реализации функции Open-point-point см. в разделе Реализация Open.

Примеры

См. примеры библиотек DLL ресурсов.

Требования

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

LogEvent

Функции Entry-Point библиотеки ресурсов

SetResourceStatus