X509CertificateInitiatorServiceCredential.SetCertificate Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает сертификат, используемый для шифрования сообщений, отправленных клиенту службой. Этот параметр используется только для привязок, настроенных на работу в режиме проверки подлинности сообщений MutualCertificateDuplex.
Перегрузки
| SetCertificate(String, StoreLocation, StoreName) |
Позволяет указать сертификат, который будет использоваться для шифрования сообщений клиенту, по различающемуся имени субъекта. Этот параметр используется только для привязок, настроенных на работу в режиме проверки подлинности сообщений |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Указывает сертификат, используемый для шифрования сообщений клиенту. Этот параметр используется только для привязок, настроенных на работу в режиме проверки подлинности сообщений |
SetCertificate(String, StoreLocation, StoreName)
Позволяет указать сертификат, который будет использоваться для шифрования сообщений клиенту, по различающемуся имени субъекта. Этот параметр используется только для привязок, настроенных на работу в режиме проверки подлинности сообщений 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)Параметры
- subjectName
- String
Различающееся имя субъекта.
- storeLocation
- StoreLocation
Расположение хранилища сертификатов, из которого служба получает сертификат.
- storeName
- StoreName
Имя открываемого хранилища сертификатов X.509.
Примеры
В следующем примере кода показано, как с помощью этого метода задать сертификат.
Комментарии
Дополнительные сведения о параметре subjectName см. в разделе SubjectName.
Значения для параметра storeLocation включены в перечисление StoreLocation.
LocalMachine: хранилище сертификатов, назначенное локальному компьютеру (по умолчанию).
CurrentUser: хранилище сертификатов, используемое текущим пользователем.
Если клиентское приложение выполняется под учетной записью системы, то сертификат обычно находится в LocalMachine. Если клиентское приложение выполняется под учетной записью пользователя, то сертификат обычно находится в CurrentUser.
Значения для параметра storeName включены в перечисление StoreName.
Применяется к
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Указывает сертификат, используемый для шифрования сообщений клиенту. Этот параметр используется только для привязок, настроенных на работу в режиме проверки подлинности сообщений 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)Параметры
- storeLocation
- StoreLocation
Расположение хранилища сертификатов, из которого служба получает сертификат.
- storeName
- StoreName
Имя открываемого хранилища сертификатов X.509.
- findType
- X509FindType
Тип поиска сертификата X.509.
- findValue
- Object
Значение для поиска в хранилище сертификатов X.509.
Примеры
В следующем примере кода показано, как с помощью этого метода задать сертификат.
Комментарии
Значения для параметра storeLocation включены в перечисление StoreLocation.
LocalMachine: хранилище сертификатов, назначенное локальному компьютеру (по умолчанию).
CurrentUser: хранилище сертификатов, используемое текущим пользователем.
Если приложение выполняется под учетной записью системы, то сертификат обычно находится в LocalMachine. Если приложение выполняется под учетной записью пользователя, то сертификат обычно находится в CurrentUser.
Значения для параметра storeName включены в перечисление StoreName.
Значения для параметра findType включены в перечисление X509FindType.
Наиболее часто используется перечисление FindBySubjectName, которое выполняет поиск с учетом регистра по имени субъекта сертификатов в указанном хранилище. Это может быть неточный поиск. Если сертификаты не найдены либо найдено несколько сертификатов, удовлетворяющих условиям поиска, вызывается исключение InvalidOperationException.
