IDebugClient::CreateClient method (dbgeng.h)

Article
02/22/2024

The CreateClient method creates a new client object for the current thread.

Syntax

HRESULT CreateClient(
  [out] PDEBUG_CLIENT *Client
);

Parameters

[out] Client

Receives an interface pointer for the new client.

Return value

This method may also return error values. See Return Values for more details.

Return code	Description
S_OK	The method was successful.

Remarks

This method creates a client that may be used in the current thread.

Clients are specific to the thread that created them. Calls from other threads fail immediately. The CreateClient method is a notable exception; it allows creation of a new client for a new thread.

All callbacks for a client are made in the thread with which the client was created.

For more information about client objects and how they are used in the debugger engine, see Client Objects.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)