LoaderVerifierGetHash (Compact 7)

3/12/2014

The function returns a hash value for the given file.

Syntax

HRESULT LoaderVerifierGetHash(
    __in HANDLE                    hslauthnFile,
    __in_opt LPCWSTR               pszHashAlgorithm,
    __in_bcount_opt(cbHash) BYTE*  pbHash,
    __in DWORD                     cbHash,
    __out_opt DWORD*               pcbHash,
    __deref_opt_out LPWSTR*        ppszHashAlgorithm
);

Parameters

• hslauthnFile
  [in] Handle to the authentication information obtained by calling LoaderVerifierAuthenticateFile.

• pszHashAlgorithm
  [in] Pointer to the algorithm identifier for the hash algorithm that returns the hash value. If this parameter is NULL, the loader uses a default hash algorithm. To retrieve the hash calculated with a specific algorithm, specify the algorithm by using a non-NULL value for the szHashHint parameter in the call to LoaderVerifierAuthenticateFile.

• pbHash
  [in] Pointer to a variable that receives the hash value for the file. This parameter can be NULL.

• cbHash
  [in] Variable that specifies the size, in bytes, of the buffer that pbHash points to. This parameter is ignored if pbHash is NULL.

• pcbHash
  [out] Pointer to a variable that receives the required size of the pbHash buffer, in bytes, when the function exits. This parameter can be NULL if pbHash is not NULL.

• ppszHashAlgorithm
  [out] Pointer to a variable that receives the algorithm identifier for the hash algorithm that was used to calculate the hash.

Return Value

The values described in the following table are possible return values. If the function is unsuccessful, it returns a standard error code indicating the cause.

Requirements

See Also

Reference

Security Loader Functions
LoaderVerifierAuthenticateFile