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

  • Статья

Функция 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