Funzione StrongNameSignatureGenerationEx

  • Articolo

Genera una firma con nome sicuro per l'assembly specificato, in base ai flag specificati.

Questa funzione è stata deprecata. Utilizzare invece il metodo ICLRStrongName::StrongNameSignatureGenerationEx .

Sintassi

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

Parametri

wszFilePath
[in] Percorso del file contenente il manifesto dell'assembly per cui verrà generata la firma del nome sicuro.

wszKeyContainer
[in] Nome del contenitore della chiave contenente la coppia di chiavi pubblica/privata.

Se pbKeyBlob è Null, wszKeyContainer deve specificare un contenitore valido all'interno del provider di servizi di crittografia . In questo caso, la coppia di chiavi archiviata nel contenitore viene usata per firmare il file.

Se pbKeyBlob non è Null, si presuppone che la coppia di chiavi sia contenuta nell'oggetto BLOB (Key Binary Large Object).

pbKeyBlob
[in] Puntatore alla coppia di chiavi pubblica/privata. Questa coppia è nel formato creato dalla funzione Win32 CryptExportKey . Se pbKeyBlob è Null, si presuppone che il contenitore della chiave specificato da wszKeyContainer contenga la coppia di chiavi.

cbKeyBlob
[in] Dimensioni, in byte, di pbKeyBlob.

ppbSignatureBlob
[out] Puntatore alla posizione in cui Common Language Runtime restituisce la firma. Se ppbSignatureBlob è Null, il runtime archivia la firma nel file specificato da wszFilePath.

Se ppbSignatureBlob non è Null, Common Language Runtime alloca lo spazio in cui restituire la firma. Il chiamante deve liberare questo spazio usando la funzione StrongNameFreeBuffer .

pcbSignatureBlob
[out] Dimensioni, in byte, della firma restituita.

dwFlags
[in] Uno o più dei valori seguenti:

  • SN_SIGN_ALL_FILES (0x00000001): ricompilare tutti gli hash per i moduli collegati.

  • SN_TEST_SIGN (0x00000002) - Firma di test dell'assembly.

Valore restituito

true al completamento positivo; in caso contrario, false.

Commenti

Specificare Null per wszFilePath calcolare le dimensioni della firma senza creare la firma.

La firma può essere archiviata direttamente nel file o restituita al chiamante.

Se SN_SIGN_ALL_FILES è specificato, ma non è inclusa una chiave pubblica (entrambe pbKeyBlob e wszFilePath sono Null), gli hash per i moduli collegati vengono ricompilate, ma l'assembly non viene rifirmato.

Se SN_TEST_SIGN specificato, l'intestazione common language runtime non viene modificata per indicare che l'assembly viene firmato con un nome sicuro.

Se la funzione non viene completata correttamente, chiamare la StrongNameSignatureGenerationEx funzione StrongNameErrorInfo per recuperare l'ultimo errore generato.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: StrongName.h

Libreria: Incluso come risorsa in MsCorEE.dll

Versioni di .NET Framework: Disponibile da 1.0

Vedi anche