Função SignerSign

Artigo
06/13/2023

A função SignerSign assina o arquivo especificado.

Observação

Essa função não tem nenhum arquivo de cabeçalho associado ou biblioteca de importação. Para chamar essa função, você deve criar um arquivo de cabeçalho definido pelo usuário e usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Mssign32.dll.

Sintaxe

HRESULT WINAPI SignerSign(
  _In_     SIGNER_SUBJECT_INFO   *pSubjectInfo,
  _In_     SIGNER_CERT           *pSignerCert,
  _In_     SIGNER_SIGNATURE_INFO *pSignatureInfo,
  _In_opt_ SIGNER_PROVIDER_INFO  *pProviderInfo,
  _In_opt_ LPCWSTR               pwszHttpTimeStamp,
  _In_opt_ PCRYPT_ATTRIBUTES     psRequest,
  _In_opt_ LPVOID                pSipData
);

Parâmetros

pSubjectInfo [in]

Um ponteiro para uma estrutura SIGNER_SUBJECT_INFO que especifica o assunto a ser assinado.

pSignerCert [in]

Um ponteiro para uma estrutura SIGNER_CERT que especifica o certificado a ser usado para criar a assinatura digital.

pSignatureInfo [in]

Um ponteiro para uma estrutura SIGNER_SIGNATURE_INFO que contém informações sobre a assinatura digital.

pProviderInfo [in, opcional]

Um ponteiro para uma estrutura SIGNER_PROVIDER_INFO que especifica o CSP ( provedor de serviços criptográficos ) e as informações de chave privada usadas para criar a assinatura digital.

Se o valor desse parâmetro for NULL, o valor do parâmetro pSignerCert deverá especificar um certificado associado a um CSP.

pwszHttpTimeStamp [in, opcional]

A URL de um servidor de carimbo de data/hora.

psRequest [in, opcional]

Um ponteiro para uma matriz de estruturas de CRYPT_ATTRIBUTE que são adicionadas a uma solicitação de sinal. Esse parâmetro será ignorado se o parâmetro pwszHttpTimeStamp não contiver um valor válido que não seja NULL.

pSipData [in, opcional]

Um valor de 32 bits que é passado como dados adicionais para funções SIP. O formato e o conteúdo disso são definidos pelo provedor SIP.

Valor retornado

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

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

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]
DLL	Mssign32.dll

Confira também

SignerSignEx

Partilhar via