Функция CryptGetMessageSignerCount (wincrypt.h)

  • Статья

Функция CryptGetMessageSignerCount возвращает количество подписывателей подписанного сообщения.

Примечание

Эта функция может возвращать количество повторяющихся подписывателей и, следовательно, может быть недостаточно для предотвращения атак. Мы рекомендуем использовать поле sid (SignerIdentifier) из SignerInfo для идентификации повторяющихся подписывателей в сообщении.

Синтаксис

LONG CryptGetMessageSignerCount(
  [in] DWORD      dwMsgEncodingType,
  [in] const BYTE *pbSignedBlob,
  [in] DWORD      cbSignedBlob
);

Параметры

[in] dwMsgEncodingType

Указывает используемый тип кодирования. Всегда допустимо указывать типы кодирования сертификатов и сообщений, объединяя их с побитовой операцией ИЛИ , как показано в следующем примере:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

В настоящее время определены следующие типы кодирования:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pbSignedBlob

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

[in] cbSignedBlob

Размер подписанного сообщения в байтах.

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

Возвращает число подписывателей подписанного сообщения, ноль, если подписывателей нет, и минус 1 (–1) для ошибки.

Для получения дополнительных сведений об ошибке вызовите Метод GetLastError. Чаще всего возвращается следующий код ошибки.

Код возврата Описание
E_INVALIDARG
 Недопустимый тип кодирования сообщений. В настоящее время поддерживается только PKCS_7_ASN_ENCODING.
 

Если функция завершается сбоем, GetLastError может вернуть ошибку кодирования и декодирования абстрактной синтаксической нотации 1 (ASN.1). Сведения об этих ошибках см. в разделе Кодирование и декодирование возвращаемых значений ASN.1.

Требования

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

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

CryptVerifyMessageSignature

Упрощенные функции сообщений