Pkcs12Info.VerifyMac Metoda

Definice

Obor názvů:

System.Security.Cryptography.Pkcs

Sestavení:

System.Security.Cryptography.Pkcs.dll

Pokusí se ověřit integritu AuthenticatedSafe obsahu pomocí hesla.

Přetížení

VerifyMac(ReadOnlySpan<Char>)	Pokusí se ověřit integritu AuthenticatedSafe obsahu pomocí hesla reprezentované objektem System.ReadOnlySpan{System.Char}.
VerifyMac(String)	Pokusí se ověřit integritu AuthenticatedSafe obsahu pomocí hesla reprezentované objektem String.

Poznámky

Není možné odlišit chybu kvůli nesprávnému heslu od chyby kvůli změně obsahu.

Obvykle se jedná o to, že heslem chráněný PFX používá stejné heslo pro algoritmus MAC poskytující integritu a šifrovací algoritmus poskytující důvěrnost, ale formát souboru to nevyžaduje. Proto není zaručeno, že heslo, které má za true následek návrat z této metody, bude úspěšné při volání Decrypt.

VerifyMac(ReadOnlySpan<Char>)

Pokusí se ověřit integritu AuthenticatedSafe obsahu pomocí hesla reprezentované objektem 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>

Heslo, které se má použít k pokusu o ověření integrity.

Návraty

Boolean

true pokud heslo úspěšně ověřuje integritu AuthenticatedSafe obsahu; false pokud heslo není správné nebo byl obsah změněn.

Výjimky

InvalidOperationException

Hodnota IntegrityMode není Password.

CryptographicException

Možnost hashovacího algoritmu určená obsahem PKCS#12 PFX nelze identifikovat nebo ji tato platforma nepodporuje.

Poznámky

Ve specifikaci PKCS#12 se rozlišuje mezi heslem null a "prázdným" heslem a tento rozdíl se odráží ve návratové hodnotě této metody. ReadOnlySpan<Char>.Empty null představuje heslo a String.Empty.AsSpan() představuje "prázdné" heslo. Pokud jedna z těchto dvou hodnot vrátí true, druhá ne.

VerifyMac(String)

Pokusí se ověřit integritu AuthenticatedSafe obsahu pomocí hesla reprezentované objektem 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

Heslo, které se má použít k pokusu o ověření integrity.

Návraty

Boolean

true pokud heslo úspěšně ověřuje integritu AuthenticatedSafe obsahu; false pokud heslo není správné nebo byl obsah změněn.

Výjimky

InvalidOperationException

Hodnota IntegrityMode není Password.

CryptographicException

Možnost hashovacího algoritmu určená obsahem PKCS#12 PFX nelze identifikovat nebo ji tato platforma nepodporuje.

Poznámky

Ve specifikaci PKCS#12 se rozlišuje mezi heslem null a "prázdným" heslem a tento rozdíl se odráží ve návratové hodnotě této metody. Pokud řetězec null vrátí true, vrátí String.Empty se falsea naopak.