Функция CryptSetKeyIdentifierProperty (wincrypt.h)

Статья
08/27/2023

Важно Этот API является устаревшим. Новое и существующее программное обеспечение должно начать использовать API-интерфейсы шифрования следующего поколения. Корпорация Майкрософт может удалить этот API в будущих выпусках.

Функция CryptSetKeyIdentifierProperty задает свойство указанного идентификатора ключа. Эта функция может задать свойство на компьютере, определяемом в pwszComputerName.

Синтаксис

BOOL CryptSetKeyIdentifierProperty(
  [in]  const CRYPT_HASH_BLOB *pKeyIdentifier,
  [in]  DWORD                 dwPropId,
  [in]  DWORD                 dwFlags,
  [in]  LPCWSTR               pwszComputerName,
  [in]  void                  *pvReserved,
  [out] const void            *pvData
);

Параметры

[in] pKeyIdentifier

Указатель на CRYPT_HASH_BLOB , содержащий идентификатор ключа.

[in] dwPropId

Определяет свойство, которое необходимо задать. Значение dwPropId определяет тип и содержимое параметра pvData . Можно использовать любой идентификатор свойства сертификата. CERT_KEY_PROV_INFO_PROP_ID является наиболее интересующим свойством.

[in] dwFlags

Можно задать следующие флаги. Их можно сочетать с побитовой операцией ИЛИ .

Значение	Значение
CRYPT_KEYID_MACHINE_FLAG	Задает свойство LocalMachine (если pwszComputerName имеет значение NULL) или удаленного компьютера (если pwszComputerName не равно NULL). Дополнительные сведения см. в разделе pwszComputerName.
CRYPT_KEYID_DELETE_FLAG	Идентификатор ключа и все его свойства удаляются.
CRYPT_KEYID_SET_NEW_FLAG	Задает новое свойство идентификатора ключа. Если свойство уже существует, попытка завершается сбоем, и возвращается значение FALSE , а для последнего кода ошибки задано значение CRYPT_E_EXISTS.

[in] pwszComputerName

Указатель на строку, завершающуюся значением NULL, которая содержит имя удаленного компьютера с идентификатором ключа, для которого заданы свойства. Если CRYPT_KEYID_MACHINE_FLAG флаг установлен, выполняет поиск на удаленном компьютере списка идентификаторов ключей. Если требуется задать локальный компьютер, а не удаленный компьютер, задайте для pwszComputerName значение NULL.

[in] pvReserved

Зарезервировано для использования в будущем и должно иметь значение NULL.

[out] pvData

Если параметр dwPropId CERT_KEY_PROV_INFO_PROP_ID, pvData указывает на структуру CRYPT_KEY_PROV_INFO , содержащую свойство идентификатора ключа.

Если параметр dwPropId не CERT_KEY_PROV_INFO_PROP_ID, pvData указывает на структуру CRYPT_DATA_BLOB , содержащую свойство идентификатора ключа.

Если параметру pvData присвоено значение NULL , свойство удаляется.

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

Если функция выполнена успешно, возвращаемое значение не равно нулю (TRUE).

Если функция завершается ошибкой, возвращаемое значение равно нулю (FALSE). Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Примечание Если CRYPT_KEYID_SET_NEW_FLAG задано и свойство уже существует, возвращается значение FALSE , а для последнего кода ошибки задано значение CRYPT_E_EXISTS.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wincrypt.h
Библиотека	Crypt32.lib
DLL	Crypt32.dll

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

CryptEnumKeyIdentifierProperties

CryptGetKeyIdentifierProperty

Функции идентификаторов ключей

Поделиться через