Rfc3161TimestampRequest.CreateFromData 方法

定義

命名空間:

System.Security.Cryptography.Pkcs

組件:

System.Security.Cryptography.Pkcs.dll

使用所指定演算法來雜湊提供的資料，以建立時間戳記要求。

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

時間戳記授權單位 (TSA) 應該使用之時間戳記原則的物件識別碼 (OID)，或使用 null 表示沒有偏好。

nonce

Nullable<ReadOnlyMemory<Byte>>

唯一識別此要求以將它與回應配對的選擇性 nonce (使用一次的數字)。 值會被解譯為不帶正負號的位元組由大到小，而且可能會被正規化為編碼格式。

requestSignerCertificates

Boolean

true 以指出時間戳記授權單位 (TSA) 必須在簽發的時間戳記權杖包括簽署憑證；否則為 false。

extensions

X509ExtensionCollection

要包含在要求中的選用延伸模組集合。

傳回

Rfc3161TimestampRequest

代表所選擇值的 Rfc3161TimestampRequest。

例外狀況

ArgumentException

hashAlgorithm.Name 是 null 或 Empty。

CryptographicException

hashAlgorithm 不是已知的雜湊演算法。

備註

密碼編譯時間戳一律會套用至資料雜湊的組合，以及用來雜湊資料的雜湊演算法演算法的演算法識別碼。 當資料尚未雜湊時，這個方法是方便的替代 CreateFromHash(ReadOnlyMemory<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection) 方法。

這個方法中的 nonce 值會被視為不帶正負號的 big-endian 整數。 這個方法會將輸入正規化為 BER INTEGER 編碼，再指派 nonce 值。 方法會傳 GetNonce() 回標準化值。

另請參閱

• CreateFromHash(ReadOnlyMemory<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)
• CreateFromSignerInfo(SignerInfo, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)