SignerInfo.CheckSignature Metoda

Definicja

Weryfikuje podpis cyfrowy wiadomości.Verifies the digital signature of the message.

Przeciążenia

CheckSignature(Boolean)

CheckSignature(Boolean)Metoda weryfikuje podpis cyfrowy wiadomości i, opcjonalnie, sprawdza poprawność certyfikatu.The CheckSignature(Boolean) method verifies the digital signature of the message and, optionally, validates the certificate.

CheckSignature(X509Certificate2Collection, Boolean)

CheckSignature(X509Certificate2Collection, Boolean)Metoda weryfikuje podpis cyfrowy wiadomości przy użyciu określonej kolekcji certyfikatów i, opcjonalnie, sprawdza poprawność certyfikatu.The CheckSignature(X509Certificate2Collection, Boolean) method verifies the digital signature of the message by using the specified collection of certificates and, optionally, validates the certificate.

CheckSignature(Boolean)

CheckSignature(Boolean)Metoda weryfikuje podpis cyfrowy wiadomości i, opcjonalnie, sprawdza poprawność certyfikatu.The CheckSignature(Boolean) method verifies the digital signature of the message and, optionally, validates the certificate.

public:
 void CheckSignature(bool verifySignatureOnly);
public void CheckSignature (bool verifySignatureOnly);
member this.CheckSignature : bool -> unit
Public Sub CheckSignature (verifySignatureOnly As Boolean)

Parametry

verifySignatureOnly
Boolean

Wartość logiczna określająca, czy jest weryfikowany tylko podpis cyfrowy.A bool value that specifies whether only the digital signature is verified. Jeśli verifySignatureOnly ma wartość true , tylko podpis zostanie zweryfikowany.If verifySignatureOnly is true, only the signature is verified. Jeśli verifySignatureOnly jest false , podpis cyfrowy zostanie zweryfikowany, łańcuch certyfikatów zostanie sprawdzony, a cele certyfikatów są weryfikowane.If verifySignatureOnly is false, the digital signature is verified, the certificate chain is validated, and the purposes of the certificates are validated. Cele certyfikatu są uznawane za prawidłowe, jeśli certyfikat nie ma użycia klucza lub jeśli użycie klucza obsługuje podpis cyfrowy lub wyprawność.The purposes of the certificate are considered valid if the certificate has no key usage or if the key usage supports digital signature or nonrepudiation.

Wyjątki

Odwołanie o wartości null zostało przesłane do metody, która nie akceptuje jej jako prawidłowego argumentu.A null reference was passed to a method that does not accept it as a valid argument.

Nie można ukończyć operacji kryptograficznej.A cryptographic operation could not be completed.

Wywołanie metody było nieprawidłowe dla bieżącego stanu obiektu.A method call was invalid for the object's current state.

Uwagi

Ta metoda zgłasza wyjątek, Jeśli weryfikacja podpisu cyfrowego nie powiedzie się lub żadne wymagania dotyczące weryfikacji nie są spełnione.This method throws an exception if the verification of the digital signature fails or any validation requirements are not met.

Jeśli wymagana jest bardziej złożona Walidacja, obiekt wywołujący może określić, że tylko podpis zostanie zweryfikowany, a następnie użyć X509Chain obiektu do przeprowadzenia niestandardowej walidacji.If more complex validation is required, the caller can specify that only the signature is verified and then use an X509Chain object to perform custom validation.

Dotyczy

CheckSignature(X509Certificate2Collection, Boolean)

CheckSignature(X509Certificate2Collection, Boolean)Metoda weryfikuje podpis cyfrowy wiadomości przy użyciu określonej kolekcji certyfikatów i, opcjonalnie, sprawdza poprawność certyfikatu.The CheckSignature(X509Certificate2Collection, Boolean) method verifies the digital signature of the message by using the specified collection of certificates and, optionally, validates the certificate.

public:
 void CheckSignature(System::Security::Cryptography::X509Certificates::X509Certificate2Collection ^ extraStore, bool verifySignatureOnly);
public void CheckSignature (System.Security.Cryptography.X509Certificates.X509Certificate2Collection extraStore, bool verifySignatureOnly);
member this.CheckSignature : System.Security.Cryptography.X509Certificates.X509Certificate2Collection * bool -> unit
Public Sub CheckSignature (extraStore As X509Certificate2Collection, verifySignatureOnly As Boolean)

Parametry

extraStore
X509Certificate2Collection

X509Certificate2CollectionObiekt, który może służyć do sprawdzania poprawności łańcucha.An X509Certificate2Collection object that can be used to validate the chain. Jeśli żadne dodatkowe certyfikaty nie będą używane do walidacji łańcucha, użyj CheckSignature(Boolean) zamiast CheckSignature(X509Certificate2Collection, Boolean) .If no additional certificates are to be used to validate the chain, use CheckSignature(Boolean) instead of CheckSignature(X509Certificate2Collection, Boolean).

verifySignatureOnly
Boolean

Wartość logiczna określająca, czy jest weryfikowany tylko podpis cyfrowy.A bool value that specifies whether only the digital signature is verified. Jeśli verifySignatureOnly ma wartość true , tylko podpis zostanie zweryfikowany.If verifySignatureOnly is true, only the signature is verified. Jeśli verifySignatureOnly jest false , podpis cyfrowy zostanie zweryfikowany, łańcuch certyfikatów zostanie sprawdzony, a cele certyfikatów są weryfikowane.If verifySignatureOnly is false, the digital signature is verified, the certificate chain is validated, and the purposes of the certificates are validated. Cele certyfikatu są uznawane za prawidłowe, jeśli certyfikat nie ma użycia klucza lub jeśli użycie klucza obsługuje podpis cyfrowy lub wyprawność.The purposes of the certificate are considered valid if the certificate has no key usage or if the key usage supports digital signature or nonrepudiation.

Wyjątki

Odwołanie o wartości null zostało przesłane do metody, która nie akceptuje jej jako prawidłowego argumentu.A null reference was passed to a method that does not accept it as a valid argument.

Nie można ukończyć operacji kryptograficznej.A cryptographic operation could not be completed.

Wywołanie metody było nieprawidłowe dla bieżącego stanu obiektu.A method call was invalid for the object's current state.

Uwagi

Ta metoda zgłasza wyjątek, Jeśli weryfikacja podpisu cyfrowego nie powiedzie się lub żadne wymagania dotyczące weryfikacji nie są spełnione.This method throws an exception if the verification of the digital signature fails or any validation requirements are not met.

Jeśli wymagana jest bardziej złożona Walidacja, obiekt wywołujący może określić, że tylko podpis zostanie zweryfikowany, a następnie użyć X509Chain obiektu do przeprowadzenia niestandardowej walidacji.If more complex validation is required, the caller can specify that only the signature is verified and then use an X509Chain object to perform custom validation.

Dotyczy