Debugging Tools for Windows

CreateClient

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

HRESULT
  IDebugClient::CreateClient(
    OUT IDebugClient * *  Client
    );

Parameters

Client
Receives an interface pointer for the new client.

Return Value

S_OK
The method was successful.

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

Interface Version

CreateClient is available in all versions of IDebugClient.

Comments

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

Headers: Defined in dbgeng.h. Include dbgeng.h.

See Also

DebugCreate

Build machine: CAPEBUILD