Поделиться через


X509CertificateInitiatorServiceCredential.SetCertificate Метод

Определение

Задает сертификат, используемый для шифрования сообщений, отправленных клиенту службой. Этот параметр используется только для привязок, настроенных на работу в режиме проверки подлинности сообщений MutualCertificateDuplex.

Перегрузки

SetCertificate(String, StoreLocation, StoreName)

Позволяет указать сертификат, который будет использоваться для шифрования сообщений клиенту, по различающемуся имени субъекта. Этот параметр используется только для привязок, настроенных на работу в режиме проверки подлинности сообщений MutualCertificateDuplex.

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

Указывает сертификат, используемый для шифрования сообщений клиенту. Этот параметр используется только для привязок, настроенных на работу в режиме проверки подлинности сообщений MutualCertificateDuplex.

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 -> unit
Public 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 -> unit
Public 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.

Применяется к