Rfc3161TimestampRequest.CreateFromData Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает запрос на присвоение метки времени, хэшируя предоставленные данные с помощью указанного алгоритма.
public static System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest CreateFromData (ReadOnlySpan<byte> data, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, System.Security.Cryptography.Oid? requestedPolicyId = default, ReadOnlyMemory<byte>? nonce = default, bool requestSignerCertificates = false, System.Security.Cryptography.X509Certificates.X509ExtensionCollection? extensions = default);
public static System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest CreateFromData (ReadOnlySpan<byte> data, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, System.Security.Cryptography.Oid requestedPolicyId = default, ReadOnlyMemory<byte>? nonce = default, bool requestSignerCertificates = false, System.Security.Cryptography.X509Certificates.X509ExtensionCollection extensions = default);
static member CreateFromData : ReadOnlySpan<byte> * System.Security.Cryptography.HashAlgorithmName * System.Security.Cryptography.Oid * Nullable<ReadOnlyMemory<byte>> * bool * System.Security.Cryptography.X509Certificates.X509ExtensionCollection -> System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest
Public Shared Function CreateFromData (data As ReadOnlySpan(Of Byte), hashAlgorithm As HashAlgorithmName, Optional requestedPolicyId As Oid = Nothing, Optional nonce As Nullable(Of ReadOnlyMemory(Of Byte)) = Nothing, Optional requestSignerCertificates As Boolean = false, Optional extensions As X509ExtensionCollection = Nothing) As Rfc3161TimestampRequest
Параметры
- data
- ReadOnlySpan<Byte>
Данные, которым необходимо присвоить метку времени и которые будут хэшированы этим методом.
- hashAlgorithm
- HashAlgorithmName
Хэш-алгоритм для использования с этим запросом на присвоение метки времени.
- requestedPolicyId
- Oid
Идентификатор объекта, для политики меток времени, которую должен использовать центр меток времени, или значение null
, если нет предпочитаемых значений.
- nonce
- Nullable<ReadOnlyMemory<Byte>>
Необязательный элемент nonce (однократно используемое число), который обеспечивает уникальную идентификацию этого запроса, чтобы связать его с ответом. Значение интерпретируется как целое число без знака с обратным порядком байтов. Оно может быть нормализовано в формат кодирования.
- requestSignerCertificates
- Boolean
Значение true
указывает, что центр меток времени должен содержать сертификат для подписи в выданном маркере метки времени. В противном случае — значение false
.
- extensions
- X509ExtensionCollection
Необязательная коллекция расширений, которую следует включить в запрос.
Возвращаемое значение
Класс Rfc3161TimestampRequest, представляющий выбранные значения.
Исключения
hashAlgorithm
— неизвестный алгоритм хэширования.
Комментарии
Криптографические метки времени всегда применяются к сочетанию хэша данных и идентификатора алгоритма, используемого для хэширования данных. Этот метод является удобной альтернативой CreateFromHash(ReadOnlyMemory<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection) , если данные еще не были хэшированы.
Значение nonce в этом методе обрабатывается как целое число без знака с большим байтом. Этот метод нормализует входные данные в кодировке BER INTEGER перед назначением значения nonce. Нормализованное значение возвращается методом GetNonce() .