Compartilhar via


Função CryptSIPPutSignedDataMsg (mssip.h)

A função CryptSIPPutSignedDataMsg armazena uma assinatura Authenticode no arquivo de destino.

Sintaxe

BOOL CryptSIPPutSignedDataMsg(
  [in]  SIP_SUBJECTINFO *pSubjectInfo,
  [in]  DWORD           dwEncodingType,
  [out] DWORD           *pdwIndex,
  [in]  DWORD           cbSignedDataMsg,
  [in]  BYTE            *pbSignedDataMsg
);

Parâmetros

[in] pSubjectInfo

Ponteiro para uma estrutura SIP_SUBJECTINFO que contém informações sobre o assunto da mensagem.

[in] dwEncodingType

O tipo de codificação da mensagem. Isso pode ser uma combinação de um ou mais dos valores a seguir.

Valor Significado
PKCS_7_ASN_ENCODING
65536 (0x10000)
Especifica a codificação de mensagens PKCS nº 7 .
X509_ASN_ENCODING
1 (0x1)
Especifica a codificação de certificado X.509 .

[out] pdwIndex

Ponteiro para o índice da mensagem.

[in] cbSignedDataMsg

Comprimento, em bytes, do buffer apontado pelo parâmetro pbSignedDataMsg .

[in] pbSignedDataMsg

Ponteiro para o buffer que contém a mensagem.

Retornar valor

Se a função for bem-sucedida, a função retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError. Alguns códigos de erro possíveis seguem.

Código de retorno Descrição
ERROR_BAD_FORMAT
Os dados especificados ou o formato de arquivo do SIP (pacote de interface do assunto ) não é válido.
ERROR_INVALID_PARAMETER
Esse código pode ser retornado pelos seguintes motivos:
  • O pSubjectInfo é NULL.
  • O pdwIndex é NULL.
  • O pbSignedDataMsg é NULL.
  • O valor do parâmetro cbSignedDataMsg é menor que um.
  • [SIP_SUBJECTINFO] Estrutura (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo). [SIP_SUBJECTINFO] Estrutura (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo).
TRUST_E_SUBJECT_FORM_UNKNOWN
O tipo de assunto especificado não é válido.

Comentários

Cada tipo de assunto usa um subconjunto diferente de seus dados para cálculo de hash e requer um procedimento diferente para armazenamento e recuperação. Portanto, cada tipo de assunto tem uma especificação SIP exclusiva.

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 mssip.h
Biblioteca Crypt32.lib
DLL Crypt32.dll

Confira também

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg