PxeTrace function (wdspxe.h)

Adds a trace entry to the PXE log.

Syntax

DWORD PXEAPI PxeTrace(
  [in] HANDLE       hProvider,
  [in] PXE_SEVERITY Severity,
  [in] LPCWSTR      pszFormat,
       ...          
);

Parameters

[in] hProvider

HANDLE passed to the PxeProviderInitialize function.

[in] Severity

Severity of trace entry.

Value Meaning
PXE_TRACE_VERBOSE
0x00010000
The trace entry is verbose and would primarily be useful when debugging.
PXE_TRACE_INFO
0x00020000
The trace entry is informational, but does not indicate a warning condition.
PXE_TRACE_WARNING
0x00040000
The trace message indicates a warning.
PXE_TRACE_ERROR
0x00080000
The trace message indicates an error condition.
PXE_TRACE_FATAL
0x00100000
The trace message indicates a fatal error condition.

[in] pszFormat

Address of a buffer that contains a printf-style format string.

...

Optional arguments. The number and type of argument parameters depend on the format control string pointed to by the pszFormat parameter.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008, Windows Server 2003 with SP2 [desktop apps only]
Target Platform Windows
Header wdspxe.h
Library WdsPxe.lib
DLL WdsPxe.dll

See also

PxeProviderInitialize

Windows Deployment Services Server Functions