Freigeben über


IPersistFileCheckSum.CalculateCheckSum-Methode

Berechnet die Prüfsumme für die Datei zugeordneten Darstellung des Textpuffers mit dem angegebenen Algorithmus.

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

Syntax

'Declaration
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

Parameter

  • guidCheckSumAlgorithm
    Typ: Guid%

    [in] GUID, der den zu verwendenden Algorithmus darstellt

  • cbBufferSize
    Typ: UInt32

    [in] übergebenen Puffers

  • pbHash
    Typ: array<Byte[]

    [out] Puffer, in den geschrieben wird die Prüfsumme

  • pcbActualSize
    Typ: UInt32%

    [out] Puffergröße erforderlich

Rückgabewert

Typ: Int32
Wenn die Methode erfolgreich ausgeführt, gibt sie S_OKzurück.Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Von textmgr2.idl:

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

Wenn die übergebene Puffergröße d. h. cbBufferSize ungleich 0 (null) ist, gibt diese Funktion E_INVALIDARGzurück. Wenn der übergebene Puffergröße (null) ist, gibt er erfolgreich zurückgegeben. In beiden Fällen ist die erforderliche Puffergröße zu pcbActualSizeReturn. Für den MD5-Algorithmus ist die maximale erforderliche erforderliche Puffergröße 16 Bytes. Für den SHA1-Algorithmus ist die maximale erforderliche Puffergröße 20 Byte

.NET Framework-Sicherheit

Siehe auch

Referenz

IPersistFileCheckSum Schnittstelle

Microsoft.VisualStudio.TextManager.Interop-Namespace