Метод EncryptedData.SetSecret

Статья
06/13/2023

[CAPICOM — это 32-разрядный компонент, доступный для использования в следующих операционных системах: Windows Server 2008, Windows Vista и Windows XP. Вместо этого используйте службы вызова платформы (PInvoke) для вызова функций API Win32 CryptEncryptMessage и CryptDecryptMessage для шифрования и расшифровки сообщений. Дополнительные сведения о PInvoke см. в руководстве по вызову платформы. .NET и CryptoAPI через P/Invoke. Часть 1 и .NET и CryptoAPI через P/Invoke: часть 2 подразделов расширения шифрования .NET с помощью CAPICOM и P/Invoke также могут быть полезны.]

Метод SetSecret задает значение секрета, используемого для получения ключа сеанса шифрования, используемого для шифрования и расшифровки данных.

Синтаксис

EncryptedData.SetSecret( _
  ByVal newVal, _
  [ ByVal SecretType ] _
)

Параметры

newVal [in]

Строка, содержащая секрет, используемый для создания криптографического ключа сеанса.

SecretType [in, необязательный]

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

Значение	Значение
CAPICOM_SECRET_PASSWORD	Ключ шифрования должен быть получен из пароля.

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

Этот метод не возвращает значение.

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

При необходимости рекомендуется использовать CryptProtectMemory или CryptProtectData для защиты секрета до и после использования. По завершении очистите память, связанную с секретом.

Требования

Требование	Значение
Окончание поддержки клиентов	Windows Vista
Окончание поддержки сервера	Windows Server 2008
Распространяемые компоненты	CAPICOM 2.0 или более поздней версии в Windows Server 2003 и Windows XP
DLL	Capicom.dll

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

Объекты шифрования
EncryptedData

Share via