AmsiInitialize function (amsi.h)

Initialize the AMSI API.

Syntax

HRESULT AmsiInitialize(
  [in]  LPCWSTR      appName,
  [out] HAMSICONTEXT *amsiContext
);

Parameters

[in] appName

The name, version, or GUID string of the app calling the AMSI API.

[out] amsiContext

A handle of type HAMSICONTEXT that must be passed to all subsequent calls to the AMSI API.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When the app is finished with the AMSI API it must call AmsiUninitialize.

Requirements

Requirement Value
Minimum supported client Windows 10 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header amsi.h
Library Amsi.lib
DLL Amsi.dll

See also

AmsiUninitialize