Méthode SignedCode.Sign

[La méthode Sign est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Utilisez plutôt les services d’appel de plateforme (PInvoke) pour appeler les fonctions SignerSignEx, SignerTimeStampEx et WinVerifyTrust de l’API Win32 pour signer du contenu avec une signature numérique Authenticode. Pour plus d’informations sur PInvoke, consultez Tutoriel sur l’appel de plateforme. Les sous-sections .NET et CryptoAPI via P/Invoke : Partie 1 et .NET et CryptoAPI via P/Invoke : Partie 2 de l’extension du chiffrement .NET avec CAPICOM et P/Invoke peuvent également être utiles.]

La méthode Sign crée une signature numérique Authenticode et signe le fichier exécutable spécifié dans la propriété SignedCode.FileName .

Syntaxe

SignedCode.Sign( _
  [ ByVal Signer ] _
)

Paramètres

Signataire [in, facultatif]

Objet Signer qui a accès à la clé privée du certificat utilisé pour signer le code. La valeur par défaut est Null.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Avant d’appeler la méthode Sign , le fichier qui contient le code doit être spécifié dans la propriété FileName .

Si le fichier exécutable est déjà signé, cette méthode remplace la signature existante.

Les résultats suivants s’appliquent à la valeur du paramètre Signer :

• Si le paramètre Signer n’est pas NULL, cette méthode utilise la clé privée pointée par le certificat associé pour chiffrer la signature. Si la clé privée pointée par le certificat n’est pas disponible, la méthode échoue.
• Si le paramètre Signer a la valeur NULL et qu’il existe exactement un certificat dans le magasin MY CURRENT_USER qui a accès à une clé privée avec la fonctionnalité de signature de code, ce certificat est utilisé pour créer la signature.
• Si le paramètre Signer a la valeur NULL, que la valeur de la propriété Settings.EnablePromptForCertificateUI a la valeur true et qu’il existe plusieurs certificats dans le magasin MY CURRENT_USER avec une clé privée disponible avec une fonctionnalité de signature de code, une boîte de dialogue s’affiche pour permettre à l’utilisateur de sélectionner le certificat utilisé.
• Si le paramètre Signer a la valeur NULL et que la propriété Settings.EnablePromptForCertificateUI a la valeur false, la méthode échoue.
• Si le paramètre Signer a la valeur NULL et qu’il n’existe aucun certificat dans le magasin MY CURRENT_USER avec une clé privée disponible avec la fonctionnalité de signature de code, la méthode échoue.

Cette méthode utilise l’algorithme de hachage SHA-1.

Spécifications