IDebugSymbols3::GetSourcePathElement method (dbgeng.h)

The GetSourcePathElement method returns an element from the source path.

Syntax

HRESULT GetSourcePathElement(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ElementSize
);

Parameters

[in] Index

Specifies the index of the element in the source path that will be returned. The source path is a string that contains elements separated by semicolons (;). The index of the first element is zero.

[out, optional] Buffer

Receives the source path element. Each source path element can be a directory or a source server. If Buffer is NULL, this information is not returned.

[in] BufferSize

Specifies the size, in characters, of the Buffer buffer.

[out, optional] ElementSize

Receives the size, in characters, of the source path element.

Return value

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

Return code Description
S_OK
The method was successful.
E_NOINTERFACE
The source path contains fewer than Index elements.

Remarks

The source path is used by the engine when searching for source files.

For more information about manipulating the source path, see Using Source Files. For an overview of the source path and its syntax, see Source Path.

Requirements

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

See also

AppendSourcePath

GetSourcePath

IDebugSymbols

IDebugSymbols2

IDebugSymbols3