Функция CryptSIPPutSignedDataMsg (mssip.h)

  • Статья

Функция CryptSIPPutSignedDataMsg сохраняет подпись Authenticode в целевом файле.

Синтаксис

BOOL CryptSIPPutSignedDataMsg(
  [in]  SIP_SUBJECTINFO *pSubjectInfo,
  [in]  DWORD           dwEncodingType,
  [out] DWORD           *pdwIndex,
  [in]  DWORD           cbSignedDataMsg,
  [in]  BYTE            *pbSignedDataMsg
);

Параметры

[in] pSubjectInfo

Указатель на структуру SIP_SUBJECTINFO , содержащую сведения о теме сообщения.

[in] dwEncodingType

Тип кодирования сообщения. Это может быть сочетание одного или нескольких из следующих значений.

Значение Значение
PKCS_7_ASN_ENCODING
65536 (0x10000)
 Задает кодировку сообщений PKCS #7 .
X509_ASN_ENCODING
1 (0x1)
 Задает кодировку сертификата X.509 .

[out] pdwIndex

Указатель на индекс сообщения.

[in] cbSignedDataMsg

Длина (в байтах) буфера, на который указывает параметр pbSignedDataMsg .

[in] pbSignedDataMsg

Указатель на буфер, содержащий сообщение.

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

Если функция выполняется успешно, функция возвращает значение TRUE.

Если функция завершается сбоем, она возвращает значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError. Ниже приведены некоторые возможные коды ошибок.

Код возврата Описание
ERROR_BAD_FORMAT
 Указанные данные или формат файла пакета интерфейса субъекта (SIP) недопустимы.
ERROR_INVALID_PARAMETER
 Этот код может быть возвращен по следующим причинам:
  • PSubjectInfo имеет значение NULL.
  • PdwIndex имеет значение NULL.
  • PbSignedDataMsg имеет значение NULL.
  • Значение параметра cbSignedDataMsg меньше единицы.
    • [SIP_SUBJECTINFO] Структура (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo). [SIP_SUBJECTINFO] Структура (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo).
TRUST_E_SUBJECT_FORM_UNKNOWN
 Указанный тип субъекта недопустим.

Комментарии

Каждый тип субъекта использует свое подмножество своих данных для вычисления хэша и требует разных процедур хранения и извлечения. Таким образом, каждый тип субъекта имеет уникальную спецификацию SIP.

Требования

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

См. также раздел

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg