Função SignerTimeStampEx2

A função SignerTimeStampEx2 carimba o assunto especificado e, opcionalmente, retorna um ponteiro para uma estrutura SIGNER_CONTEXT que contém um ponteiro para um BLOB. Essa função pode ser usada para executar a Infraestrutura de Chave Pública X.509, os carimbos de data/hora em conformidade com RFC 3161.

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 SignerTimeStampEx2(
  _Reserved_ DWORD               dwFlags,
  _In_       SIGNER_SUBJECT_INFO *pSubjectInfo,
  _In_       LPCWSTR             pwszHttpTimeStamp,
  _In_       ALG_ID              dwAlgId,
  _In_       PCRYPT_ATTRIBUTES   psRequest,
  _In_       LPVOID              pSipData,
  _Out_      SIGNER_CONTEXT      **ppSignerContext 
);

Parâmetros

dwFlags [in]

Valor que especifica o tipo de carimbo de data/hora a ser gerado. Esse parâmetro pode usar um dos valores a seguir. Os valores são mutuamente exclusivos.

Valor Significado
SIGNER_TIMESTAMP_AUTHENTICODE
Especifica um carimbo de data/hora do Authenticode.
SIGNER_TIMESTAMP_RFC3161
Especifica um carimbo de data/hora compatível com RFC 3161.

 

pSubjectInfo [in]

O endereço de uma estrutura SIGNER_SUBJECT_INFO que representa o sujeito a ser carimbado.

pwszHttpTimeStamp [in]

O endereço de uma cadeia de caracteres Unicode terminada em nulo que contém a URL de um servidor de carimbo de data/hora.

dwAlgId [in]

Especifica um algoritmo de hash a ser usado para executar carimbos de data/hora em conformidade com RFC 3161. Esse parâmetro é ignorado para carimbos de data/hora do Authenticode.

psRequest [in]

Opcional. O endereço de uma estrutura CRYPT_ATTRIBUTES que contém atributos adicionais que são adicionados à solicitação de carimbo de data/hora.

Esse parâmetro é opcional e pode ser NULL se não estiver incluído.

pSipData [in]

Opcional. Um valor de 32 bits que é passado como dados adicionais para funções SIP ( pacote de interface de entidade ). O formato e o conteúdo desse parâmetro são definidos pelo provedor SIP.

Esse parâmetro é opcional e pode ser NULL se não estiver incluído.

ppSignerContext [out]

Opcional. O endereço de um ponteiro para a estrutura SIGNER_CONTEXT que contém o BLOB assinado. Quando terminar de usar a estrutura SIGNER_CONTEXT , libere-a chamando a função SignerFreeSignerContext .

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 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 R2 [somente aplicativos da área de trabalho]
DLL
Mssign32.dll

Confira também

SignerTimeStamp

SignerTimeStampEx