X509CertificateInitiatorServiceCredential.SetCertificate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
establece el certificado que se debe usar para cifrar mensajes enviados al cliente mediante el servicio. Este valor se utiliza únicamente por los enlaces que se configuran con el MutualCertificateDuplex modo de autenticación de seguridad de mensajes.
Sobrecargas
| SetCertificate(String, StoreLocation, StoreName) |
Le permite especificar el certificado que se debe utilizar para cifrar los mensajes para el cliente especificando el nombre distintivo (DN) del asunto. Este valor se utiliza únicamente por los enlaces que se configuran con el |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Especifica el certificado que se va a utilizar para cifrar los mensajes para el cliente. Este valor se utiliza únicamente por los enlaces que se configuran con el |
SetCertificate(String, StoreLocation, StoreName)
Le permite especificar el certificado que se debe utilizar para cifrar los mensajes para el cliente especificando el nombre distintivo (DN) del asunto. Este valor se utiliza únicamente por los enlaces que se configuran con el MutualCertificateDuplex modo de autenticación de seguridad de mensajes.
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
Nombre distintivo del asunto.
- storeLocation
- StoreLocation
La ubicación del almacén de certificados que el servicio utiliza para obtener el certificado.
- storeName
- StoreName
Obtiene el nombre del almacén de certificados X.509.
Ejemplos
El siguiente código muestra cómo utilizar este método para establecer el certificado.
Comentarios
Para obtener más información acerca del parámetro subjectName, vea SubjectName.
Los valores para storeLocation están incluidos en la enumeración StoreLocation:
LocalMachine: el almacén de certificados asignado al equipo local (predeterminado).
CurrentUser: el almacén de certificados utilizado por el usuario actual.
Si la aplicación cliente se está ejecutando bajo una cuenta del sistema, entonces el certificado está normalmente en LocalMachine. Si la aplicación cliente se está ejecutando en una cuenta de usuario, entonces el certificado se encuentra normalmente en CurrentUser.
Los valores para storeName están incluidos en la enumeración StoreName.
Se aplica a
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Especifica el certificado que se va a utilizar para cifrar los mensajes para el cliente. Este valor se utiliza únicamente por los enlaces que se configuran con el MutualCertificateDuplex modo de autenticación de seguridad de mensajes.
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
La ubicación del almacén de certificados que el servicio utiliza para obtener el certificado.
- storeName
- StoreName
Obtiene el nombre del almacén de certificados X.509.
- findType
- X509FindType
El tipo de búsqueda de X.509 que se va a ejecutar.
- findValue
- Object
El valor que se va a buscar en el almacén de certificados X.509.
Ejemplos
El siguiente código muestra cómo utilizar este método para establecer el certificado.
Comentarios
Los valores para storeLocation están incluidos en la enumeración StoreLocation:
LocalMachine: el almacén de certificados asignado al equipo local (predeterminado).
CurrentUser: el almacén de certificados utilizado por el usuario actual.
Si la aplicación se está ejecutando bajo una cuenta del sistema, entonces el certificado está normalmente en LocalMachine. Si la aplicación se está ejecutando en una cuenta de usuario, entonces el certificado se encuentra normalmente en CurrentUser.
Los valores para storeName están incluidos en la enumeración StoreName.
Los valores para findType están incluidos en la enumeración X509FindType.
La enumeración normalmente utilizada es FindBySubjectName, que hace una búsqueda sin distinción entre mayúsculas y minúsculas en el nombre del asunto de certificados en el almacén especificado. Ésta puede ser una búsqueda imprecisa. Si ningún certificado o varios certifica que coinciden los criterios que se buscan, se produce InvalidOperationException.