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

Функция CryptCATPutCatAttrInfo (mscat.h)

  • Статья

[Функция CryptCATPutCatAttrInfo доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Функция CryptCATPutCatAttrInfo выделяет память для атрибута файла каталога и добавляет ее в каталог.

Синтаксис

CRYPTCATATTRIBUTE * CryptCATPutCatAttrInfo(
  [in] HANDLE hCatalog,
  [in] LPWSTR pwszReferenceTag,
  [in] DWORD  dwAttrTypeAndAction,
  [in] DWORD  cbData,
  [in] BYTE   *pbData
);

Параметры

[in] hCatalog

Дескриптор каталога, полученный из функций CryptCATOpen или CryptCATHandleFromStore .

[in] pwszReferenceTag

Указатель на строку, завершаемую null, для имени атрибута.

[in] dwAttrTypeAndAction

Значение типа , представляющее побитовое сочетание следующих флагов. Вызывающий объект должен по крайней мере указать CRYPTCAT_ATTR_DATAASCII или CRYPTCAT_ATTR_DATABASE64.

Значение Значение
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 Атрибут проходит проверку подлинности.
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 Атрибут не пройти проверку подлинности.
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 Атрибут является строкой ASCII.
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 Атрибут является идентификатором криптографического объекта (OID).
CRYPTCAT_ATTR_DATAASCII
0x00010000
 Атрибут содержит простые символы ASCII, которые не должны декодироваться.
CRYPTCAT_ATTR_DATABASE64
0x00020000
 Атрибут имеет формат Base 64.
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 Атрибут заменяет значение существующего атрибута.

[in] cbData

Значение типа , указывающее количество байтов в буфере pbData .

[in] pbData

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

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

Указатель на структуру CRYPTCATATTRIBUTE , содержащую атрибут каталога. Вызывающий объект не должен освобождать этот указатель или любой из его членов.

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

Код возврата Описание
ERROR_INVALID_PARAMETER
 Один или несколько параметров являются недопустимыми.
ERROR_NOT_ENOUGH_MEMORY
 Во время операции в операционной системе не хватает памяти.

Требования

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