Функция CryptSIPRetrieveSubjectGuidForCatalogFile (mssip.h)
Функция CryptSIPRetrieveSubjectGuidForCatalogFile извлекает GUID субъекта, связанный с указанным файлом.
Синтаксис
BOOL CryptSIPRetrieveSubjectGuidForCatalogFile(
[in] LPCWSTR FileName,
[in, optional] HANDLE hFileIn,
[out] GUID *pgSubject
);
Параметры
[in] FileName
Имя файла. Если задан параметр hFileIn , значение в этом параметре игнорируется.
[in, optional] hFileIn
Дескриптор файла для проверка. Этот параметр должен содержать допустимый дескриптор, если параметр FileName имеет значение NULL.
[out] pgSubject
Глобальный уникальный идентификатор, идентифицирующий субъект.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение равно TRUE ; в противном случае — FALSE.
Если эта функция возвращает значение FALSE, дополнительные сведения об ошибке можно получить, вызвав функцию GetLastError . GetLastError вернет один из следующих кодов ошибок.
Код возврата | Описание |
---|---|
|
Один или несколько параметров недопустимы. |
Комментарии
Эта функция поддерживает только пакеты интерфейса субъекта (SIP), которые используются для переносимых исполняемых образов (.exe), образов кабинетов (.cab) и неструктурированных файлов.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | mssip.h |
Библиотека | Crypt32.lib |
DLL | Crypt32.dll |