X509CertificateInitiatorServiceCredential.SetCertificate Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define o certificado a ser usado para criptografar mensagens enviadas ao cliente pelo serviço. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem MutualCertificateDuplex.
Sobrecargas
| SetCertificate(String, StoreLocation, StoreName) |
Permite que você especifique o certificado a ser usado para criptografar mensagens para o cliente especificando o nome diferenciado da entidade. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Especifica o certificado a ser usado para criptografar mensagens para o cliente. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem |
SetCertificate(String, StoreLocation, StoreName)
Permite que você especifique o certificado a ser usado para criptografar mensagens para o cliente especificando o nome diferenciado da entidade. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem 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)Parâmetros
- subjectName
- String
O nome diferenciado da entidade.
- storeLocation
- StoreLocation
O local do repositório de certificados que o serviço usa para obter o certificado.
- storeName
- StoreName
O nome do repositório de certificados X.509 a ser aberto.
Exemplos
O código a seguir mostra como usar esse método para definir o certificado.
Comentários
Para saber mais sobre o parâmetro subjectName, confira SubjectName.
Os valores de storeLocation são incluídos na StoreLocation enumeração :
LocalMachine: o repositório de certificados atribuído ao computador local (padrão).
CurrentUser: o repositório de certificados usado pelo usuário atual.
Se o aplicativo cliente estiver em execução em uma conta do sistema, o certificado normalmente estará em LocalMachine. Se o aplicativo cliente estiver em execução em uma conta de usuário, o certificado normalmente estará em CurrentUser.
Os valores de storeName são incluídos na StoreName enumeração .
Aplica-se a
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Especifica o certificado a ser usado para criptografar mensagens para o cliente. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem 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)Parâmetros
- storeLocation
- StoreLocation
O local do repositório de certificados que o serviço usa para obter o certificado.
- storeName
- StoreName
O nome do repositório de certificados X.509 a ser aberto.
- findType
- X509FindType
O tipo de pesquisa de X.509 a ser executada.
- findValue
- Object
O valor a ser pesquisado no repositório de certificados X.509.
Exemplos
O código a seguir mostra como usar esse método para definir o certificado.
Comentários
Os valores de storeLocation são incluídos na StoreLocation enumeração :
LocalMachine: o repositório de certificados atribuído ao computador local (padrão).
CurrentUser: o repositório de certificados usado pelo usuário atual.
Se o aplicativo estiver em execução em uma conta do sistema, o certificado normalmente estará em LocalMachine. Se o aplicativo estiver em execução em uma conta de usuário, o certificado normalmente estará em CurrentUser.
Os valores de storeName são incluídos na StoreName enumeração .
Os valores de findType são incluídos na X509FindType enumeração .
A enumeração mais usada é FindBySubjectName, que faz uma pesquisa que não diferencia maiúsculas de minúsculas no nome da entidade dos certificados no repositório especificado. Essa pode ser uma pesquisa imprecisa. Se nenhum certificado ou vários certificados que correspondem aos critérios forem encontrados, um InvalidOperationException será gerado.
