> For the complete documentation index, see [llms.txt](https://docs.medcrypt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.medcrypt.com/ko/guardian/api-overview/api-reference/namespaces/namespacemedcrypt-guardian-utilities.md).

# medcrypt::guardian::utilities

## 클래스

|     | 이름                                                                                                                                                                                                                                                                                                                                                                                                      |
| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 구조체 | <p><a href="/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-initializefiles.md"><strong>medcrypt::guardian::utilities::InitializeFiles</strong></a><br>다음에서 사용하는 초기화 파일 저장소: <a href="/ko/guardian/api-overview/api-reference/classes/classmedcrypt-guardian-guardian.md#function-initialize">Guardian::Initialize</a>.</p>                                           |
| 구조체 | <p><a href="/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md"><strong>medcrypt::guardian::utilities::ProvisionFiles</strong></a><br>다음에서 프로비저닝 요청 파일을 생성하는 데 사용하는 저장소: <a href="/ko/guardian/api-overview/api-reference/classes/classmedcrypt-guardian-guardian.md#function-generateprovisionrequest">Guardian::GenerateProvisionRequest</a>.</p>    |
| 구조체 | <p><a href="/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisiononlinefiles.md"><strong>medcrypt::guardian::utilities::ProvisionOnlineFiles</strong></a><br>다음에서 사용하는 온라인 프로비저닝 파일 저장소: <a href="/ko/guardian/api-overview/api-reference/classes/classmedcrypt-guardian-guardian.md#function-startprovisioningonline">Guardian::StartProvisioningOnline</a>.</p> |

## 함수

|      | 이름                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| bool | <p><a href="#function-getinitializefilesfrompath"><strong>GetInitializeFilesFromPath</strong></a>(const std::string & in\_filespath, const bool & in\_use\_provision\_files, <a href="/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-initializefiles.md">InitializeFiles</a> \* io\_files, const std::string & in\_prefix ="")<br>다음에 필요한 파일 버퍼를 채웁니다: <a href="/ko/guardian/api-overview/api-reference/classes/classmedcrypt-guardian-guardian.md#function-initialize">Guardian::Initialize</a> 경로에서 가져옵니다.</p>                         |
| void | <p><a href="#function-deleteinitializefilebuffers"><strong>DeleteInitializeFileBuffers</strong></a>(<a href="/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-initializefiles.md">InitializeFiles</a> \* io\_files)<br>다음에서 생성된 동적 메모리를 삭제합니다: <a href="#function-getinitializefilesfrompath">GetInitializeFilesFromPath()</a></p>                                                                                                                                                                                                         |
| bool | <p><a href="#function-getprovisionfilesfrompath"><strong>GetProvisionFilesFromPath</strong></a>(const std::string & in\_filespath, const bool & in\_use\_provision\_files, <a href="/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md">ProvisionFiles</a> \* io\_files, const std::string & in\_prefix ="")<br>다음에 필요한 파일 버퍼를 채웁니다: <a href="/ko/guardian/api-overview/api-reference/classes/classmedcrypt-guardian-guardian.md#function-generateprovisionrequest">Guardian::GenerateProvisionRequest</a> 경로에서 가져옵니다.</p> |
| void | <p><a href="#function-deleteprovisionfilebuffers"><strong>DeleteProvisionFileBuffers</strong></a>(<a href="/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md">ProvisionFiles</a> \* io\_files)<br>다음에서 생성된 동적 메모리를 삭제합니다: <a href="#function-getprovisionfilesfrompath">GetProvisionFilesFromPath()</a></p>                                                                                                                                                                                                               |

## 속성

|            | 이름                                                           |
| ---------- | ------------------------------------------------------------ |
| const char | [**kRequestExtension**](#variable-krequestextension)         |
| const char | [**kProfileExtension**](#variable-kprofileextension)         |
| const char | [**kRunProfileExtension**](#variable-krunprofileextension)   |
| const char | [**kIdentityExtension**](#variable-kidentityextension)       |
| const char | [**kRunIdentityExtension**](#variable-krunidentityextension) |
| const char | [**kTrustExtension**](#variable-ktrustextension)             |
| const char | [**kRevocationExtension**](#variable-krevocationextension)   |

## 함수 설명서

### 함수 GetInitializeFilesFromPath

```cpp
static inline bool GetInitializeFilesFromPath(
    const std::string & in_filespath,
    const bool & in_use_provision_files,
    InitializeFiles * io_files,
    const std::string & in_prefix =""
)
```

다음에서 필요한 파일 버퍼를 채웁니다:  [Guardian::Initialize](/ko/guardian/api-overview/api-reference/classes/classmedcrypt-guardian-guardian.md#function-initialize) 경로에서 가져옵니다.

**매개변수**:

* **in\_filespath** 프로필 파일의 절대 경로 또는 작업 디렉터리 기준 상대 경로
* **in\_use\_provision\_files** 온라인 프로비저닝을 실행하도록 초기화할 때 사용할 프로비저닝 프로필을 반환하는 데 사용됩니다.
* **io\_files** 채울 파일 구조체
* **in\_prefix** 검색된 각 파일에 있어야 하는 접두사입니다. 파일 접두사로 구분하여 동일한 폴더에 여러 프로필 세트를 저장할 수 있습니다.

**반환값**:

* **true** io\_files가 성공적으로 채워졌습니다.
* **false** io\_files가 채워지지 않았습니다.

**반환값**: bool

in\_filepath에서 in\_prefix 접두사가 있는 파일을 검색합니다. 접두사를 적용한 후 영숫자순으로 정렬하고 첫 번째 결과를 사용합니다.

참고: 이 함수는 다음에서 메모리를 할당합니다:  [InitializeFiles](/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-initializefiles.md) new\[]를 사용한 char\* 버퍼입니다. 이에 대응하는 [DeleteInitializeFileBuffers()](#function-deleteinitializefilebuffers) 함수는 생성된 동적 메모리를 해제합니다.

### 함수 DeleteInitializeFileBuffers

```cpp
static inline void DeleteInitializeFileBuffers(
    InitializeFiles * io_files
)
```

다음에서 생성된 동적 메모리를 해제합니다:  [GetInitializeFilesFromPath()](#function-getinitializefilesfrompath)

**매개변수**:

* **io\_files** 정리할 파일 구조체

**반환값**: 없음

모든 InitializeFiles [InitializeFiles](/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-initializefiles.md) char\* 버퍼에 delete\[]를 호출합니다.

### 함수 GetProvisionFilesFromPath

```cpp
static inline bool GetProvisionFilesFromPath(
    const std::string & in_filespath,
    const bool & in_use_provision_files,
    ProvisionFiles * io_files,
    const std::string & in_prefix =""
)
```

다음에서 필요한 파일 버퍼를 채웁니다:  [Guardian::GenerateProvisionRequest](/ko/guardian/api-overview/api-reference/classes/classmedcrypt-guardian-guardian.md#function-generateprovisionrequest) 경로에서 가져옵니다.

**매개변수**:

* **in\_filespath** 프로필 파일의 절대 경로 또는 작업 디렉터리 기준 상대 경로
* **in\_use\_provision\_files** 프로비저닝 프로필을 반환하는 데 사용됩니다. 일반적으로 true여야 합니다.
* **io\_files** 채울 파일 구조체
* **in\_prefix** 검색된 각 파일에 있어야 하는 접두사입니다. 파일 접두사로 구분하여 동일한 폴더에 여러 프로필 세트를 저장할 수 있습니다.

**반환값**:

* **true** io\_files가 성공적으로 채워졌습니다.
* **false** io\_files가 채워지지 않았습니다.

**반환값**: bool

in\_filepath에서 in\_prefix 접두사가 있는 파일을 검색합니다. 접두사를 적용한 후 영숫자순으로 정렬하고 첫 번째 결과를 사용합니다.

참고: 이 함수는 다음에서 메모리를 할당합니다:  [ProvisionFiles](/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md) new\[]를 사용한 char\* 버퍼입니다. 이에 대응하는 [DeleteProvisionFileBuffers()](#function-deleteprovisionfilebuffers) 함수는 생성된 동적 메모리를 삭제합니다.

참고: 이 함수는 출력용 메모리를 생성하지 않습니다. [ProvisionFiles::ProvisionRequest](/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md#variable-provisionrequest) 또는 [ProvisionFiles::GeneratedPrivateIdentity](/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md#variable-generatedprivateidentity)

### 함수 DeleteProvisionFileBuffers

```cpp
static inline void DeleteProvisionFileBuffers(
    ProvisionFiles * io_files
)
```

에서 생성된 동적 메모리를 삭제합니다. [GetProvisionFilesFromPath()](#function-getprovisionfilesfrompath)

**매개변수**:

* **io\_files** 정리할 파일 구조체

**반환값**: 없음

모든 [ProvisionFiles](/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md) 출력용을 제외한 char\* 버퍼에 delete\[]를 호출합니다. [ProvisionFiles::ProvisionRequest](/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md#variable-provisionrequest) 및 [ProvisionFiles::GeneratedPrivateIdentity](/ko/guardian/api-overview/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md#variable-generatedprivateidentity)

## 속성 문서

### 변수 kRequestExtension

```cpp
static const char kRequestExtension = ".mcpr";
```

프로비저닝 요청 파일 확장자

### 변수 kProfileExtension

```cpp
static const char kProfileExtension = ".mcpp";
```

인증된 프로비저닝 프로필 파일 확장자

### 변수 kRunProfileExtension

```cpp
static const char kRunProfileExtension = ".mcp";
```

인증된 프로필 파일 확장자

### 변수 kIdentityExtension

```cpp
static const char kIdentityExtension = ".mcpip";
```

프로비저닝 개인 ID 파일 확장자

### 변수 kRunIdentityExtension

```cpp
static const char kRunIdentityExtension = ".mcpi";
```

개인 ID 파일 확장자

### 변수 kTrustExtension

```cpp
static const char kTrustExtension = ".mcts";
```

신뢰 저장소 파일 확장자

### 변수 kRevocationExtension

```cpp
static const char kRevocationExtension = ".mccrl";
```

인증서 폐기 목록 파일 확장자


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.medcrypt.com/ko/guardian/api-overview/api-reference/namespaces/namespacemedcrypt-guardian-utilities.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.