Pkcs12Info.Decode(ReadOnlyMemory<Byte>, Int32, Boolean) Método

Definição

Namespace:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Origem:

Pkcs12Info.cs

Lê os dados fornecidos como um PFX PKCS nº 12 e retorna uma exibição de objeto do conteúdo.

public static System.Security.Cryptography.Pkcs.Pkcs12Info Decode (ReadOnlyMemory<byte> encodedBytes, out int bytesConsumed, bool skipCopy = false);

static member Decode : ReadOnlyMemory<byte> * int * bool -> System.Security.Cryptography.Pkcs.Pkcs12Info

Public Shared Function Decode (encodedBytes As ReadOnlyMemory(Of Byte), ByRef bytesConsumed As Integer, Optional skipCopy As Boolean = false) As Pkcs12Info

Parâmetros

encodedBytes

ReadOnlyMemory<Byte>

Os dados a serem interpretados como um PFX PKCS nº 12.

bytesConsumed

Int32

Quando esse método retorna, contém um valor que indica o número de bytes de encodedBytes que foram lidos por esse método. Esse parâmetro é tratado como não inicializado.

skipCopy

Boolean

true para armazenar encodedBytes sem fazer uma cópia defensiva; caso contrário, false. O padrão é false.

Retornos

Pkcs12Info

Uma exibição de objeto do PFX PKCS nº 12 decodificada da entrada.

Exceções

CryptographicException

O conteúdo do parâmetro encodedBytes não foi decodificado com êxito como um PFX PKCS nº 12.

Comentários

O comportamento padrão desse método é fazer uma cópia defensiva dos primeiros bytesConsumed bytes de encodedBytes. Quando o skipCopy parâmetro é true, essa cópia defensiva é ignorada. Se a cópia defensiva for ignorada e o conteúdo dos primeiros bytesConsumed bytes de encodedBytes alteração durante o tempo de vida do valor retornado ou de qualquer objeto produzido por seus métodos ou propriedades, métodos e propriedades nesses objetos poderão produzir resultados absurdos ou gerar exceções devido ao estado corrompido. Portanto, é recomendável que os chamadores usem apenas um true valor para o skipCopy parâmetro quando puderem ter certeza de que os dados permanecerão intactos.