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

Статья
08/27/2023

Функция CryptSetOIDFunctionValue задает значение для указанного типа кодирования, имени функции, OID и имени значения.

Синтаксис

BOOL CryptSetOIDFunctionValue(
  [in] DWORD      dwEncodingType,
  [in] LPCSTR     pszFuncName,
  [in] LPCSTR     pszOID,
  [in] LPCWSTR    pwszValueName,
  [in] DWORD      dwValueType,
  [in] const BYTE *pbValueData,
  [in] DWORD      cbValueData
);

Параметры

[in] dwEncodingType

Указывает тип кодировки для сопоставления. В настоящее время используются только X509_ASN_ENCODING и PKCS_7_ASN_ENCODING; однако в будущем могут быть добавлены дополнительные типы кодирования. Чтобы сопоставить оба текущих типа кодировки, используйте:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

[in] pszFuncName

Имя функции, для которой обновляется тип кодирования, идентификатор идентификатора и имя значения.

[in] pszOID

Если слово высокого порядка идентификатора объекта (OID) не равно нулю, pszOID является указателем на строку OID, например "2.5.29.1", или строку ASCII , например "file". Если слово высокого порядка в OID равно нулю, слово низкого порядка задает целочисленный идентификатор, который будет использоваться в качестве идентификатора объекта.

[in] pwszValueName

Указатель на строку Юникода, содержащую имя устанавливаемого значения. Если значение с таким именем еще не существует, функция создает его.

[in] dwValueType

Указывает тип сведений, которые будут храниться в качестве данных значения. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
REG_DWORD	32-разрядное число.
REG_EXPAND_SZ	Строка Юникода, завершающаяся null, которая содержит нерасширенные ссылки на переменные среды (например, "%PATH%").
REG_MULTI_SZ	Массив строк Юникода с завершением NULL, заканчивающихся двумя символами NULL .
REG_SZ	Строка Юникода, заканчивающаяся null.

[in] pbValueData

Указывает на буфер, содержащий данные, которые необходимо сохранить для указанного имени значения.

[in] cbValueData

Задает размер (в байтах) сведений, на которые указывает параметр pbValueData . Если данные относятся к типу REG_SZ, REG_EXPAND_SZ или REG_MULTI_SZ, размер должен включать символ конца в ширину null .

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

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

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

Требования

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

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

Функции поддержки OID

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