Pkcs12Info.VerifyMac Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography.Pkcs

Zestaw:

System.Security.Cryptography.Pkcs.dll

Pakiet:

System.Security.Cryptography.Pkcs v9.0.0-preview.5.24306.7

Próbuje zweryfikować integralność AuthenticatedSafe zawartości przy użyciu hasła.

Przeciążenia

VerifyMac(ReadOnlySpan<Char>)	Próbuje zweryfikować integralność AuthenticatedSafe zawartości przy użyciu hasła reprezentowanego przez element System.ReadOnlySpan{System.Char}.
VerifyMac(String)	Próbuje zweryfikować integralność AuthenticatedSafe zawartości przy użyciu hasła reprezentowanego przez element String.

Uwagi

Nie można odróżnić błędu z powodu nieprawidłowego hasła z powodu zmiany zawartości.

Zwykle jest tak, że chroniony hasłem PFX używa tego samego hasła dla algorytmu MAC zapewniającego integralność i algorytm szyfrowania zapewniający poufność, ale format pliku nie wymaga tego. W związku z tym nie ma gwarancji, że hasło, które powoduje true zwrot z tej metody, powiedzie się po wywołaniu metody .Decrypt

VerifyMac(ReadOnlySpan<Char>)

Źródło:

Pkcs12Info.cs

Próbuje zweryfikować integralność AuthenticatedSafe zawartości przy użyciu hasła reprezentowanego przez element System.ReadOnlySpan{System.Char}.

public:
 bool VerifyMac(ReadOnlySpan<char> password);

public bool VerifyMac (ReadOnlySpan<char> password);

member this.VerifyMac : ReadOnlySpan<char> -> bool

Public Function VerifyMac (password As ReadOnlySpan(Of Char)) As Boolean

Parametry

password

ReadOnlySpan<Char>

Hasło do użycia do próby zweryfikowania integralności.

Zwraca

Boolean

true jeśli hasło pomyślnie weryfikuje integralność AuthenticatedSafe zawartości; false jeśli hasło nie jest poprawne lub zawartość została zmieniona.

Wyjątki

InvalidOperationException

Wartość IntegrityMode nie Passwordjest .

CryptographicException

Nie można zidentyfikować opcji algorytmu skrótu określonego przez zawartość PKCS#12 PFX lub nie jest obsługiwana przez tę platformę.

Uwagi

W specyfikacji PKCS#12 rozróżnia się hasło i "puste" hasło, a różnica ta null jest odzwierciedlana w wartości zwracanej tej metody. ReadOnlySpan<Char>.Emptynull reprezentuje hasło i String.Empty.AsSpan() reprezentuje hasło "puste". Jeśli jedna z tych dwóch wartości zwróci truewartość , druga nie zostanie zwrócona.

VerifyMac(String)

Źródło:

Pkcs12Info.cs

Próbuje zweryfikować integralność AuthenticatedSafe zawartości przy użyciu hasła reprezentowanego przez element String.

public:
 bool VerifyMac(System::String ^ password);

public bool VerifyMac (string? password);

member this.VerifyMac : string -> bool

Public Function VerifyMac (password As String) As Boolean

Parametry

password

String

Hasło do użycia do próby zweryfikowania integralności.

Zwraca

Boolean

true jeśli hasło pomyślnie weryfikuje integralność AuthenticatedSafe zawartości; false jeśli hasło nie jest poprawne lub zawartość została zmieniona.

Wyjątki

InvalidOperationException

Wartość IntegrityMode nie Passwordjest .

CryptographicException

Nie można zidentyfikować opcji algorytmu skrótu określonego przez zawartość PKCS#12 PFX lub nie jest obsługiwana przez tę platformę.

Uwagi

W specyfikacji PKCS#12 rozróżnia się hasło i "puste" hasło, a różnica ta null jest odzwierciedlana w wartości zwracanej tej metody. null Jeśli ciąg zwróci truewartość , String.Empty zwraca falsewartość , i na odwrót.