CryptographicEngine.Sign(CryptographicKey, IBuffer) 方法

定义

命名空间:

Windows.Security.Cryptography.Core

对数字内容进行签名。 有关详细信息，请参阅 MAC、哈希和签名。

public:
 static IBuffer ^ Sign(CryptographicKey ^ key, IBuffer ^ data);

 static IBuffer Sign(CryptographicKey const& key, IBuffer const& data);

public static IBuffer Sign(CryptographicKey key, IBuffer data);

function sign(key, data)

Public Shared Function Sign (key As CryptographicKey, data As IBuffer) As IBuffer

参数

key

CryptographicKey

用于签名的密钥。

data

IBuffer

要签名的数据。

返回

IBuffer

数据的签名。

示例

public IBuffer SampleCreateHMAC(
    String strMsg,
    String strAlgName,
    out IBuffer buffMsg,
    out CryptographicKey hmacKey)
{
    // Create a MacAlgorithmProvider object for the specified algorithm.
    MacAlgorithmProvider objMacProv = MacAlgorithmProvider.OpenAlgorithm(strAlgName);

    // Create a buffer that contains the message to be signed.
    BinaryStringEncoding encoding = BinaryStringEncoding.Utf8;
    buffMsg = CryptographicBuffer.ConvertStringToBinary(strMsg, encoding);

    // Create a key to be signed with the message.
    IBuffer buffKeyMaterial = CryptographicBuffer.GenerateRandom(objMacProv.MacLength);
    hmacKey = objMacProv.CreateKey(buffKeyMaterial);

    // Sign the key and message together.
    IBuffer buffHMAC = CryptographicEngine.Sign(hmacKey, buffMsg);

    // Verify that the HMAC length is correct for the selected algorithm
    if (buffHMAC.Length != objMacProv.MacLength)
    {
        throw new Exception("Error computing digest");
    }

    // Return the HMAC.
    return buffHMAC;
}

注解

如果密钥是持久密钥，并且操作需要 UI 或花费很长时间，请改用 SignAsync 方法。

有关对数字数据进行签名的详细信息，请参阅 MAC、哈希和签名。