X509CertificateInitiatorServiceCredential.SetCertificate Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit le certificat à utiliser pour chiffrer les messages envoyés au client par le service. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message MutualCertificateDuplex.
Surcharges
| SetCertificate(String, StoreLocation, StoreName) |
Vous permet de spécifier le certificat à utiliser pour chiffrer les messages pour le client en spécifiant le nom unique du sujet. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Spécifie le certificat à utiliser pour chiffrer les messages pour le client. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message |
SetCertificate(String, StoreLocation, StoreName)
Vous permet de spécifier le certificat à utiliser pour chiffrer les messages pour le client en spécifiant le nom unique du sujet. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message MutualCertificateDuplex.
public:
void SetCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);public void SetCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);member this.SetCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unitPublic Sub SetCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)Paramètres
- subjectName
- String
Nom unique de l'objet.
- storeLocation
- StoreLocation
L'emplacement du magasin de certificats que le service utilise pour obtenir le certificat.
- storeName
- StoreName
Le nom du magasin de certificats X.509 à ouvrir.
Exemples
Le code suivant montre comment utiliser cette méthode pour définir le certificat.
Remarques
Pour plus d'informations sur le paramètre subjectName, consultez SubjectName.
Les valeurs pour storeLocation sont incluses dans l'énumération StoreLocation :
LocalMachine : le magasin de certificats assigné à l'ordinateur local (par défaut).
CurrentUser : le magasin de certificats utilisé par l'utilisateur actuel.
Si l'application cliente s'exécute sous un compte système, le certificat se trouve généralement dans LocalMachine. Si l'application cliente s'exécute sous un compte d'utilisateur, le certificat se trouve généralement dans CurrentUser.
Les valeurs pour storeName sont incluses dans l'énumération StoreName.
S’applique à
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Spécifie le certificat à utiliser pour chiffrer les messages pour le client. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message MutualCertificateDuplex.
public:
void SetCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);public void SetCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);member this.SetCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unitPublic Sub SetCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)Paramètres
- storeLocation
- StoreLocation
L'emplacement du magasin de certificats que le service utilise pour obtenir le certificat.
- storeName
- StoreName
Le nom du magasin de certificats X.509 à ouvrir.
- findType
- X509FindType
Le type de recherche X.509 à exécuter.
- findValue
- Object
Valeur à rechercher dans le magasin de certificats X.509.
Exemples
Le code suivant montre comment utiliser cette méthode pour définir le certificat.
Remarques
Les valeurs pour storeLocation sont incluses dans l'énumération StoreLocation :
LocalMachine : le magasin de certificats assigné à l'ordinateur local (par défaut).
CurrentUser : le magasin de certificats utilisé par l'utilisateur actuel.
Si l'application s'exécute sous un compte système, le certificat se trouve généralement dans LocalMachine. Si l'application s'exécute sous un compte d'utilisateur, le certificat se trouve généralement dans CurrentUser.
Les valeurs pour storeName sont incluses dans l'énumération StoreName.
Les valeurs pour findType sont incluses dans l'énumération X509FindType.
L'énumération la plus communément utilisée est FindBySubjectName, qui recherche dans le magasin spécifié (non sensible à la casse) le nom de sujet des certificats. Cette recherche peut être imprécise. Si aucun certificat ou plusieurs certificats qui correspondent aux critères sont trouvés, l'exception InvalidOperationException est levée.
