GetExtensionByPath

The GetExtensionByPath and GetExtensionByPathWide methods return the handle for an already loaded extension library.

HRESULT
  IDebugControl::GetExtensionByPath(
    IN PCSTR  Path,
    OUT PULONG64  Handle
    );

HRESULT
  IDebugControl4::GetExtensionByPathWide(
    IN PCWSTR  Path,
    OUT PULONG64  Handle
    );

#ifdef UNICODE
#define GetExtensionByPathT GetExtensionByPathWide
#else
#define GetExtensionByPathT GetExtensionByPath
#endif

Parameters

Path

Specifies the fully qualified path and file name of the extension library.

Handle

Receives the handle of the extension library.

Return Value

S_OK

The method was successful.

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

Interface Version

GetExtensionByPath is available in all versions of IDebugControl. GetExtensionByPathWide is available in IDebugControl4 and later versions.

Comments

Extension libraries are loaded into the host engine, which is where this method looks for the requested extension library. Path is a path and file name for the host engine.

For more information on using extension libraries, see Calling Extensions and Extension Functions.

Requirements

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

See Also

AddExtension