IDebugAdvanced2::GetSourceFileInformation method

The GetSourceFileInformation method returns specified information about a source file.


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


Which [in]

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


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.


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

The method was successful.


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



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


Target platform



Dbgeng.h (include Dbgeng.h)

See also




Send comments about this topic to Microsoft