Partilhar via

Função CryptCATPutAttrInfo (mscat.h)

  • Artigo

[A função CryptCATPutAttrInfo 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 CryptCATPutAttrInfo aloca memória para um atributo e a adiciona a um membro do catálogo.

Sintaxe

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

Parâmetros

[in] hCatalog

Um identificador para o catálogo obtido da função CryptCATOpen ou CryptCATHandleFromStore .

[in] pCatMember

Um ponteiro para uma estrutura CRYPTCATMEMBER que contém o membro do catálogo.

[in] pwszReferenceTag

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém 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_DATABASE64 ou CRYPTCAT_ATTR_DATAASCII.

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.

Retornar valor

Após o sucesso, essa função retorna um ponteiro para uma estrutura CRYPTCATATTRIBUTE que contém o atributo atribuído. 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

Requisito Valor
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