ArcInitPluginDataW структура

 Начало  Предыдущая  Следующая

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

Используется в функции ArcInitPluginW.

Синтаксис C++

typedef struct ArcInitPluginDataW {

                unsigned short       VersMajor;

                unsigned short       VersMinor;

                unsigned short       out_VersMajor;

                unsigned short       out_VersMinor;

                wchar_t              *PluginFileName;

                ArcGetPasswordProcW  ArcGetPasswordW;

                ArcShowDialogProcW   ArcShowDialogW;

                ArcParamFromPlugProc ArcParamFromPlug;

                tChangeVolProc       ChangeVol;

                tChangeVolProcW      ChangeVolW;

                wchar_t              DefaultIniNameW[MAX_PATH];

                wchar_t              *out_Extensions;

                unsigned int         out_PackerCaps;

                unsigned int         out_PackerCapsEx;

                LONG_PTR             Reserved[8];

};

 

Члены

VersMajor и VersMinor

Тип: unsigned short

На входе функции ArcInitPluginW здесь указывается основной и дополнительный номера версии спецификации ACX-плагинов. Программа указывает эти номера для информирования плагина о том, какую версию он должен поддерживать.

out_VersMajor и out_VersMinor

Тип: unsigned short

На выходе плагин должен в этих поля указать какую известную ему версию ACX-спецификации он поддерживает (для того, чтобы программа могла оценить, как она может использовать этот плагин).

Плагин обязан заполнить эти поля.

PluginFileName

Тип: wchar_t*

Указатель на 0-терминированное имя файла плагина (включая полный путь). Может использоваться, например, для получения папки плагина с файлами его настроек.

Если плагин использует данную строку, то её необходимо скопировать в свою область памяти, изменять её нельзя.

ArcGetPasswordW

Тип: ArcGetPasswordProcW

Указатель на функцию ArcGetPasswordProcW. Используется для открытия диалога получения пароля архива.

Плагин должен запомнить этот указатель, если собирается вызывать функцию.

ArcShowDialogW

Тип: ArcShowDialogProcW

Указатель на функцию, для отображения отформатированного сообщения.

Плагин должен запомнить этот указатель, если собирается вызывать функцию.

ArcParamFromPlug

Тип: ArcParamFromPlugProc

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

Плагин должен запомнить этот указатель, если он собирается сообщать программе некоторые дополнительные параметры.

ChangeVolProc

Тип: tChangeVolProc

Используйте вместо этого аналогичное поле ChangeVolProcW (см. ниже).

ChangeVolProcW

Тип: tChangeVolProcW

Используется для диалога с пользователем при смене устройства. Плагин должен запомнить указатель на эту функцию для последующего её вызова.

Данное поле заменяет вызов устаревших SetChangeVolProc и SetChangeVolProcW.

DefaultIniNameW

Тип: wchar_t[MAX_PATH]

Имя ini-файла в котором плагину предлагается сохранять свои свойства.

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

Данное поле заменяет собой использование функции PackSetDefaultParams.

out_Extensions

Тип: wchar_t*

Желательно, чтобы сюда плагин записывал указатель на строку списка расширений, которые он поддерживает, либо плагин не должен менять это поле.

Расширения отделяются друг от друга символом ",". Если символ "," является частью расширения, то он может быть экранирован символом "\".

out_PackerCaps

Тип: unsigned int

Сюда плагин может записать флаги, описывающие его поведение согласно таблице.

Поле out_PackerCaps заменяет собой устаревшую функцию GetPackerCaps.

out_PackerCapsEx

Тип: unsigned int

Сюда плагин может записать флаги, описывающие его дополнительное поведение согласно таблице.