Skip to main content
Sets the platform callbacks.

Syntax

Parameters

threadIdCallback   _In_
Type: HCTracePlatformThisThreadIdCallback*
The thread ID callback. threadIdContext   _In_opt_
Type: void*
The thread ID context. writeToDebuggerCallback   _In_
Type: HCTracePlatformWriteMessageToDebuggerCallback*
The write to debugger callback. writeToDebuggerContext   _In_opt_
Type: void*
The write to debugger context.

Return value

Type: HRESULT Result code for this API operation. Possible values are S_OK or E_HC_ALREADY_INITIALISED (0x89235004). The function returns E_HC_ALREADY_INITIALISED if tracing is already initialized. Call HCTraceSetPlatformCallbacks before HCInitialize or HCTraceInit.

Remarks

Use this function to supply thread ID and debugger output hooks to libHttpClient builds that use the generic platform tracing implementation.
The XBOX Game Development Kit (GDK) builds of libHttpClient for Windows PC and XBOX consoles store these callbacks but don’t call them. They use GetCurrentThreadId for thread IDs and OutputDebugStringA for debugger output. Most GDK games don’t need to call this function.

Requirements

Header: trace.h Library: libHttpClient.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

See also

trace
HCTracePlatformThisThreadIdCallback
HCTracePlatformWriteMessageToDebuggerCallback
Last modified on October 30, 2026