Функция 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 вернет один из следующих кодов ошибок.

Код возврата Описание
ERROR_INVALID_PARAMETER
 Один или несколько параметров недопустимы.

Комментарии

Эта функция поддерживает только пакеты интерфейса субъекта (SIP), которые используются для переносимых исполняемых образов (.exe), образов кабинетов (.cab) и неструктурированных файлов.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header mssip.h
Библиотека Crypt32.lib
DLL Crypt32.dll