Método IPersistFileCheckSum.CalculateCheckSum

Artigo
05/17/2015

Calcula a soma de verificação para a representação de arquivo do buffer de texto associado usando o algoritmo especificado.

Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop.8.0 (em Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Sintaxe

'Declaração
Function CalculateCheckSum ( _
    ByRef guidCheckSumAlgorithm As Guid, _
    cbBufferSize As UInteger, _
    <OutAttribute> pbHash As Byte(), _
    <OutAttribute> ByRef pcbActualSize As UInteger _
) As Integer

int CalculateCheckSum(
    ref Guid guidCheckSumAlgorithm,
    uint cbBufferSize,
    byte[] pbHash,
    out uint pcbActualSize
)

int CalculateCheckSum(
    [InAttribute] Guid% guidCheckSumAlgorithm, 
    [InAttribute] unsigned int cbBufferSize, 
    [OutAttribute] array<unsigned char>^ pbHash, 
    [OutAttribute] unsigned int% pcbActualSize
)

abstract CalculateCheckSum : 
        guidCheckSumAlgorithm:Guid byref * 
        cbBufferSize:uint32 * 
        pbHash:byte[] byref * 
        pcbActualSize:uint32 byref -> int

function CalculateCheckSum(
    guidCheckSumAlgorithm : Guid, 
    cbBufferSize : uint, 
    pbHash : byte[], 
    pcbActualSize : uint
) : int

Parâmetros

guidCheckSumAlgorithm
Tipo: Guid%

[in] GUID que representa o algoritmo para usar

cbBufferSize
Tipo: UInt32

[in] Tamanho do buffer passado

pbHash
Tipo: array<Byte[]

[out] Buffer no qual a soma de verificação é gravada.

pcbActualSize
Tipo: UInt32%

[out] Tamanho do buffer necessário

Valor de retorno

Tipo: Int32
Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De textmgr2.idl:

HRESULT IPersistFileCheckSum::CalculateCheckSum(
   [in] REFGUID guidCheckSumAlgorithm,
   [in] DWORD cbBufferSize,
   [out, size_is(cbBufferSize)] BYTE *pbHash,
   [out] DWORD *pcbActualSize
);

Se o buffer passado no tamanho ou seja, cbBufferSizeé diferente de zero, essa função retornará E_INVALIDARG. Mas se passado no buffer de tamanho é zero, ele retorna o sucesso. Em ambos os casos, o tamanho do buffer necessário é retorno por meio de pcbActualSize. Para o algoritmo MD5, o máximo necessário o tamanho do buffer necessário é de 16 bytes. Para o algoritmo SHA1, o valor máximo necessário é de tamanho do buffer de 20 bytes

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

IPersistFileCheckSum Interface

Namespace Microsoft.VisualStudio.TextManager.Interop

Partilhar via