> For the complete documentation index, see [llms.txt](https://nviasoft.gitbook.io/nviasoft-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nviasoft.gitbook.io/nviasoft-docs/api-reference/item-parsing/gettraceinfo.md).

# GetTraceInfo

### public unsafe int GetTraceInfo(int TRID, ref int plSampleCount, ref int plVidCount, ref string pstrVidList, ref string pstrPeriod)

등록된 특정 TRID(Trace Request ID)의 상세 설정 정보를 가져옵니다. 호스트가 `S2F23` 메시지를 통해 요청한 트레이스 작업이 장비에 어떻게 설정되어 있는지(몇 번 보고할지, 어떤 주기로 보낼지 등)를 확인할 때 사용합니다.

Parameters

<table data-header-hidden><thead><tr><th width="164"></th><th width="115"></th><th></th></tr></thead><tbody><tr><td><strong>Name</strong></td><td><strong>Type</strong></td><td><strong>Description</strong></td></tr><tr><td>TRID</td><td>int</td><td>조회하려는 트레이스 요청 ID</td></tr><tr><td>plSampleCount</td><td>ref int</td><td>(Output) 총 샘플링 횟수 (Total Samples)</td></tr><tr><td>plVidCount</td><td>ref int</td><td>(Output) 트레이스 대상 변수(VID)의 개수</td></tr><tr><td>pstrVidList</td><td>ref string</td><td>(Output) 트레이스 대상 VID 리스트 (문자열 형태)</td></tr><tr><td>pstrPeriod</td><td>ref string</td><td>(Output) 샘플링 주기 (HHMMSS 형식의 문자열)</td></tr></tbody></table>

```csharp
int trid = 1;
int sampleCount = 0;
int vidCount = 0;
string vidList = "";
string period = "";

int result = m_gem.GetTraceInfo(trid, ref sampleCount, ref vidCount, ref vidList, ref period);

if (result >= 0)
{
    Console.WriteLine($"[Trace ID {trid} 정보]");
    Console.WriteLine($"- 샘플 횟수: {sampleCount}");
    Console.WriteLine($"- 변수 개수: {vidCount}");
    Console.WriteLine($"- 대상 VID: {vidList}");
    Console.WriteLine($"- 수집 주기: {period}");
}
else
{
    Console.WriteLine($"트레이스 정보를 가져오지 못했습니다. (Error: {result})");
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nviasoft.gitbook.io/nviasoft-docs/api-reference/item-parsing/gettraceinfo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.