Функция обратного вызова pfnIsFileSupportedName (mssip.h)
Функция обратного вызова pfnIsFileSupportedName запрашивает пакеты интерфейса субъекта (SIP), перечисленные в реестре, чтобы определить, какой SIP обрабатывает тип файла.
Синтаксис
pfnIsFileSupportedName Pfnisfilesupportedname;
BOOL Pfnisfilesupportedname(
[in] WCHAR *pwszFileName,
[out] GUID *pgSubject
)
{...}
Параметры
[in] pwszFileName
Указатель на строку, завершающуюся значением NULL, которая содержит абсолютный путь к файлу, обрабатываемый SIP.
[out] pgSubject
ИДЕНТИФИКАТОР GUID, определяющий SIP, который обрабатывает тип файла.
Возвращаемое значение
Возвращаемое значение равно TRUE , если функция выполнена успешно; False , если функция завершается сбоем. Если функция завершается сбоем, вызовите функцию GetLastError , чтобы определить причину сбоя.
Комментарии
Если SIP поддерживает тип файла, передаваемый hfile, функция возвращает значение TRUE и присваивает pgSubject идентификатор GUID, определяющий SIP для обработки этого типа файла.
Каждый SIP реализует собственную версию функции, которая определяет, поддерживается ли тип файла. Конкретное имя функции может отличаться в зависимости от реализации SIP, но сигнатура функции будет соответствовать сигнатуре SIP_ADD_NEWPROVIDER структуры.
Поставщики SIP должны поддерживать ограниченный набор типов файлов и расширений файлов. Функция fileSupportedName должна проверка, что предоставленный файл соответствует одному из расширений файлов, поддерживаемых SIP. Например, протокол SIP WSH поддерживает только следующий список расширений файлов и проверяет, является ли проверяемый файл членом следующего списка: .js, JSE, VBE, VBS или WSF.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | mssip.h |