Функция SignerTimeStampEx2

Статья
06/13/2023

Функция SignerTimeStampEx2 метки времени указанного субъекта и при необходимости возвращает указатель на структуру SIGNER_CONTEXT , содержащую указатель на большой двоичный объект. Эту функцию можно использовать для выполнения инфраструктуры открытых ключей X.509, совместимой с RFC 3161, меток времени.

Примечание

У этой функции нет связанного файла заголовка или библиотеки импорта. Чтобы вызвать эту функцию, необходимо создать определяемый пользователем файл заголовка и использовать функции LoadLibrary и GetProcAddress для динамического связывания с Mssign32.dll.

Синтаксис

HRESULT WINAPI SignerTimeStampEx2(
  _Reserved_ DWORD               dwFlags,
  _In_       SIGNER_SUBJECT_INFO *pSubjectInfo,
  _In_       LPCWSTR             pwszHttpTimeStamp,
  _In_       ALG_ID              dwAlgId,
  _In_       PCRYPT_ATTRIBUTES   psRequest,
  _In_       LPVOID              pSipData,
  _Out_      SIGNER_CONTEXT      **ppSignerContext 
);

Параметры

dwFlags [in]

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

Значение	Значение
SIGNER_TIMESTAMP_AUTHENTICODE	Указывает метку времени Authenticode.
SIGNER_TIMESTAMP_RFC3161	Указывает метку времени, совместимую с RFC 3161.

pSubjectInfo [in]

Адрес структуры SIGNER_SUBJECT_INFO , представляющей субъект, на который распространяется метка времени.

pwszHttpTimeStamp [in]

Адрес строки Юникода, завершаемой null, которая содержит URL-адрес сервера меток времени.

dwAlgId [in]

Указывает хэш-алгоритм, который будет использоваться для выполнения меток времени, совместимых с RFC 3161. Этот параметр игнорируется для меток времени Authenticode.

psRequest [in]

Необязательный элемент. Адрес структуры CRYPT_ATTRIBUTES , содержащей дополнительные атрибуты, добавляемые в запрос метки времени.

Этот параметр является необязательным и может иметь значение NULL , если он не включен.

pSipData [in]

Необязательный элемент. 32-разрядное значение, которое передается в качестве дополнительных данных в функции пакета интерфейса субъекта (SIP). Формат и содержимое этого параметра определяется поставщиком SIP.

Этот параметр является необязательным и может иметь значение NULL , если он не включен.

ppSignerContext [out]

Необязательный элемент. Адрес указателя на структуру SIGNER_CONTEXT , содержащую подписанный BLOB-объект. Завершив использование структуры SIGNER_CONTEXT , освободите ее, вызвав функцию SignerFreeSignerContext .

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

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

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
DLL	Mssign32.dll

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

SignerTimeStamp
SignerTimeStampEx

Share via