Função CryptCATPutCatAttrInfo (mscat.h)

  • Artigo

[A função CryptCATPutCatAttrInfo está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A função CryptCATPutCatAttrInfo aloca memória para um atributo de arquivo de catálogo e a adiciona ao catálogo.

Sintaxe

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

Parâmetros

[in] hCatalog

Um identificador para o catálogo obtido das funções CryptCATOpen ou CryptCATHandleFromStore .

[in] pwszReferenceTag

Um ponteiro para uma cadeia de caracteres terminada em nulo para o nome do atributo.

[in] dwAttrTypeAndAction

Um valor que representa uma combinação bit a bit dos sinalizadores a seguir. O chamador deve pelo menos especificar CRYPTCAT_ATTR_DATAASCII ou CRYPTCAT_ATTR_DATABASE64.

Valor Significado
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 O atributo é autenticado.
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 O atributo não está autenticado.
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 O atributo é uma cadeia de caracteres ASCII.
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 O atributo é um OID ( identificador de objeto criptográfico).
CRYPTCAT_ATTR_DATAASCII
0x00010000
 O atributo contém caracteres ASCII simples que não devem ser decodificados.
CRYPTCAT_ATTR_DATABASE64
0x00020000
 O atributo está no formato base 64.
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 O atributo substitui o valor de um atributo existente.

[in] cbData

Um valor que especifica o número de bytes no buffer pbData .

[in] pbData

Um ponteiro para um buffer de memória que contém o valor do atributo.

Valor retornado

Um ponteiro para uma estrutura CRYPTCATATTRIBUTE que contém o atributo de catálogo. O chamador não deve liberar esse ponteiro ou qualquer um de seus membros.

Se essa função retornar NULL, informações de erro adicionais poderão ser obtidas chamando a função GetLastError . GetLastError retornará um dos seguintes códigos de erro.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros não são válidos.
ERROR_NOT_ENOUGH_MEMORY
 O sistema operacional ficou sem memória durante a operação.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mscat.h
Biblioteca Wintrust.lib
DLL Wintrust.dll