Приложения
Приложение А. Функции, константы и структуры RDS
А.3. События модуля автокомпиляции и связанные с ними структуры
А.3.4. События модуля автокомпиляции
А.3.4.18. RDS_COMPM_SAVESYSTEM – сохранение схемы
Первый параметр функции модуля (int CallMode)
Константа RDS_COMPM_SAVESYSTEM.
Третий параметр функции модуля (void *ExtParam)
Указатель на структуру RDS_COMPSAVESYSTEMDATA, содержащую новое и прежнее имена файла сохраняемой схемы.
Возвращаемое функцией модуля значение
Не используется, можно возвращать любое значение.
Примечания
Событие RDS_COMPM_SAVESYSTEM возникает перед сохранением всей схемы, реакция на него вызывается один раз для каждого модуля автокомпиляции. Эта реакция может использоваться, например, для предложения пользователю сделать копии всех моделей для новой схемы, если он сохраняет схему под другим именем.
В параметре ExtParam при реакции на это событие передается указатель на структуру RDS_COMPSAVESYSTEMDATA:
typedef struct { RDSCSTR FileNameA; // Имя сохраняемого файла (UTF8) RDSWCSTR FileNameW; // Имя сохраняемого файла (UTF16) //RDSXCSTR FileName; // Имя сохраняемого файла (поле-псевдоним) RDSCSTR OldFileNameA; // Имя файла до сохранения или NULL при первом сохранении (UTF8) RDSWCSTR OldFileNameW; // Имя файла до сохранения или NULL при первом сохранении (UTF16) //RDSXCSTR OldFileName; // Имя файла до сохранения или NULL при первом сохранении (поле-псевдоним) } RDS_COMPSAVESYSTEMDATA; typedef RDS_COMPSAVESYSTEMDATA *RDS_PCOMPSAVESYSTEMDATA;
Поля структуры
- FileNameA (RDSCSTR), FileNameW (RDSWCSTR), FileName (RDSXCSTR)
- Указатель на строку с полным путем к сохраняемому файлу схемы во внутренней памяти RDS. Функция модуля не должна изменять эту строку.
- OldFileNameA (RDSCSTR), OldFileNameW (RDSWCSTR), OldFileName (RDSXCSTR)
- Указатель на строку с прежним именем файла (при прошлом сохранении) или NULL, если только что созданная схема сохраняется в первый раз. Если схема сохраняется в тот же самый файл, что и в прошлый раз, значение поля будет совпадать с полем FileName. Эта строка находится во внутренней памяти RDS, функция модуля не должна изменять ее.
См. также