Cmd

главная

Функция Cmd позволяет запрашивать различную информацию и выполнять управляющие действия.

DWORD WINAPI SRAPI_Cmd(
  SR_COMMAND_TYPE CMD,
  void *Param
);

Параметры

Cmd
Тип команды. Может быть одним из следующих:
Узнать версию S&R (SANDR_VERSION - эта константа указывает на версию S&R, заголовочный файл от которой используется). Возвращается версия в следующем формате:
HIWORD:  0 (зарезервировано для будущего использования)
LOWORD:  HIBYTE = major version (S&R 1.7 = 0x01)
         LOBYTE = minor version (S&R 1.7 = 0x07)
Param - игноруруется.
Получить некую внутреннюю строковую переменную S&R. Param - указатель на SR_CMD_GetString. Возвращается TRUE в случае успеха и FALSE при неудаче. Если SR_CMD_GetString.Dest равно NULL или SR_CMD_GetString.MaxSize меньше, чем нужно, то возвращается FALSE, а в SR_CMD_GetString.Size записывается требуемый размер буфера с учетом заключающего нуля.
Получить некое внутреннее число S&R. Param - указатель на SR_CMD_GetSetting. Возвращается TRUE в случае успеха и FALSE при неудаче.
Задать вопрос-подтверждение (с односложным ответом). Param - указатель на SR_CMD_Question. Возвращается TRUE - "Да", FALSE - "Нет".
Установить курсор на нужный объект в панелях. Param - указатель на строку-путь к объекту. Возвращается TRUE в случае успеха.
Показать сообщение об ошибке. Param - указатель на SR_CMD_ErrorMsg. Возвращается TRUE.
Узнать сообщение OS об последней ошибке (в OEM). Param - указатель на SR_CMD_GetSystemMsg. Возвращается TRUE.
Позволяет запросить подтверждение обработки файла с атрибутом "только для чтения". Param - указатель на SR_CMD_AskProcessROFile. Возвращается: если SR_CMD_AskProcessROFile.OnlyYesNo равно TRUE, то 0 для "Отменить" и 1 для "Обработать", если SR_CMD_AskProcessROFile.OnlyYesNo равно FALSE, то 0 для "Отменить", 1 для "Обработать", 2 для "Все", 3 для "Пропустить" и 4 для "Пропустить все".
Param
См. описание конкретной команды.

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

Смотрите описание конкретной команды.
Смотрите также:
Сервисные функции