IDebugAdvanced2::GetSourceFileInformation method

The GetSourceFileInformation method returns specified information about a source file.

Syntax


HRESULT GetSourceFileInformation(
  [in]            ULONG   Which,
  [in]            PSTR    SourceFile,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parameters

Which [in]

Specifies the piece of information to return. The Which parameter can take one of the values in the following table.

DEBUG_SRCFILE_SYMBOL_TOKEN

Returns a token representing the specified source file on a source server. This token can be passed to FindSourceFileAndToken to retrieve information about the file. The token is returned to the Buffer buffer as an array of bytes. The size of this token is a reflection of the size of the SrcSrv token.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Queries a source server for the command to extract the source file from source control. This includes the name of the executable file and its command-line parameters. The command is returned to the Buffer buffer as a Unicode string.

SourceFile [in]

Specifies the source file whose information is being requested. The source file is looked up on all the source servers in the source path.

Arg64 [in]

Specifies a 64-bit argument. The value of Which specifies the module whose symbol token is requested. Regardless of the value of Which, Arg64 is a location within the memory allocation of the module.

Arg32 [in]

Specifies a 32-bit argument. This parameter is currently unused.

Buffer [out, optional]

Receives the requested symbol information. The type of the data returned depends on the value of Which. If Buffer is NULL, this information is not returned.

BufferSize [in]

Specifies the size in bytes of the Buffer buffer. If Buffer is NULL, BufferSize must also be NULL.

InfoSize [out, optional]

Specifies the size in bytes of the information returned to the Buffer buffer. This parameter can be NULL if the data is not required.

Return value

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

Return codeDescription
S_OK

The method was successful.

S_FALSE

The method was successful. However, the information would not fit in the Buffer buffer, so the information or name was truncated.

 

Remarks

For more information about source files, see Using Source Files.

Requirements

Target platform

Desktop

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugAdvanced2
IDebugAdvanced3
FindSourceFileAndToken

 

 

Send comments about this topic to Microsoft

Show: