Função SignerSignEx
A função SignerSignEx assina o arquivo especificado e retorna um ponteiro para os dados assinados.
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 SignerSignEx(
_In_ DWORD dwFlags,
_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,
_Out_ SIGNER_CONTEXT **ppSignerContext
);
Parâmetros
-
dwFlags [in]
-
Modifica o comportamento dessa função.
Se o arquivo a ser assinado for um arquivo PE (executável portátil), isso poderá ser zero ou uma combinação de um ou mais dos valores a seguir. Esses identificadores são definidos em Mssip.h.
Valor Significado - SPC_EXC_PE_PAGE_HASHES_FLAG
- 0x10
Exclua hashes de página ao criar dados indiretos SIP para o arquivo PE. Esse sinalizador tem precedência sobre o sinalizador SPC_INC_PE_PAGE_HASHES_FLAG .
Se nem a SPC_EXC_PE_PAGE_HASHES_FLAG nem o sinalizador SPC_INC_PE_PAGE_HASHES_FLAG for especificado, o valor definido com a função WintrustSetDefaultIncludePEPageHashes será usado para essa configuração. O padrão para essa configuração é excluir hashes de página ao criar dados indiretos SIP para arquivos PE.
Windows Server 2003 e Windows XP: Não há suporte para esse valor.- SPC_INC_PE_IMPORT_ADDR_TABLE_FLAG
- 0x20
Não há suporte para esse valor. - SPC_INC_PE_DEBUG_INFO_FLAG
- 0x40
Não há suporte para esse valor. - SPC_INC_PE_RESOURCES_FLAG
- 0x80
Não há suporte para esse valor. - SPC_INC_PE_PAGE_HASHES_FLAG
- 0x100
Inclua hashes de página ao criar dados indiretos SIP para o arquivo PE.
Windows Server 2003 e Windows XP: Não há suporte para esse valor. -
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 as informações de CSP ( provedor de serviços criptográficos ) e 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.
-
ppSignerContext [out]
-
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 estrutura SIGNER_CONTEXT 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 XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| DLL |
|
Confira também