Função de StrongNameSignatureGenerationEx

Gera uma assinatura de nome forte para o assembly especificado, de acordo com os sinalizadores especificados.

Essa função foi preterida na .NET Framework versão 4. Use o ICLRStrongName::StrongNameSignatureGenerationEx método em vez disso.

BOOLEAN StrongNameSignatureGenerationEx (
    [in]  LPCWSTR   wszFilePath,
    [in]  LPCWSTR   wszKeyContainer,
    [in]  BYTE      *pbKeyBlob,
    [in]  ULONG     cbKeyBlob,
    [out] BYTE      **ppbSignatureBlob,
    [out] ULONG     *pcbSignatureBlob,
    [in]  DWORD     dwFlags
);

Parâmetros

  • wszFilePath
    [in] O caminho para o arquivo que contém o manifesto do assembly para o qual a assinatura de nome forte será gerada.

  • wszKeyContainer
    [in] O nome do recipiente de chave que contém o par de chaves pública/particular.

    Se pbKeyBlob for nulo, wszKeyContainer deve especificar um contêiner válido no provedor de serviços de criptografia (CSP). Nesse caso, o par de chaves armazenado no contêiner é usado para assinar o arquivo.

    Se pbKeyBlob não for nulo, o par de chaves é assumido estejam contidas no chave grande BLOB (objeto binário).

  • pbKeyBlob
    [in] Um ponteiro para o par de chaves pública/particular. Esse par está no formato criado pelo Win32 CryptExportKey função. Se pbKeyBlob é nulo, o recipiente de chave especificado por wszKeyContainer será adotada para conter o par de chaves.

  • cbKeyBlob
    [in] O tamanho, em bytes, do pbKeyBlob.

  • ppbSignatureBlob
    [out] Um ponteiro para o local ao qual o common language runtime retorna a assinatura. Se ppbSignatureBlob é nulo, o tempo de execução armazena a assinatura no arquivo especificado por wszFilePath.

    Se ppbSignatureBlob é não nulo, o common language runtime aloca espaço retornar a assinatura. O chamador deve liberar esse espaço usando o StrongNameFreeBuffer função.

  • pcbSignatureBlob
    [out] O tamanho em bytes, da assinatura retornada.

  • dwFlags
    [in] Um ou mais dos seguintes valores:

    • SN_SIGN_ALL_FILES(0x00000001) - recompilar todos os hashes para módulos vinculados.

    • SN_TEST_SIGN(0x00000002) - teste-sign the assembly.

Valor de retorno

trueApós a conclusão bem-sucedida; Caso contrário, false.

Comentários

Especifique nulo para wszFilePath para calcular o tamanho da assinatura sem o criando assinatura.

A assinatura pode ser armazenada diretamente no arquivo, ou retornada ao chamador.

Se SN_SIGN_ALL_FILES for especificado, mas uma chave pública não está incluída (ambos pbKeyBlob e wszFilePath são nulos), os hashes para módulos vinculados serão recalculados, mas o assembly não está assinado novamente.

Se SN_TEST_SIGN for especificado, o cabeçalho de tempo de execução de linguagem comum não é modificado para indicar que o assembly é assinado com um nome forte.

Se a StrongNameSignatureGenerationEx função não concluída com êxito, chame o StrongNameErrorInfo função para recuperar o último erro gerado.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: StrongName.h

Biblioteca: Incluído como um recurso em mscoree

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Consulte também

Referência

Interface de ICLRStrongName

Outros recursos

Método de ICLRStrongName::StrongNameSignatureGenerationEx

Método de ICLRStrongName::StrongNameSignatureGeneration

Histórico de alterações

Date

History

Motivo

Julho de 2010

Link para a alternativa recomendada adicionado.

Aprimoramento de informações.