# oh_preferences_option.h


## 概述

提供访问Preferences配置选项（PreferencesOption）的接口与数据结构。

**引用文件：**<database/preferences/oh_preferences_option.h>

**库：** libohpreferences.so

**系统能力：** SystemCapability.DistributedDataManager.Preferences.Core

**起始版本：** 13

**相关模块：**[Preferences](_preferences.md)


## 汇总


### 类型定义

| 名称 | 描述 | 
| -------- | -------- |
| typedef struct [OH_PreferencesOption](_preferences.md#oh_preferencesoption) [OH_PreferencesOption](_preferences.md#oh_preferencesoption) | 定义Preferences配置选项的数据结构。 | 


### 函数

| 名称 | 描述 | 
| -------- | -------- |
| [OH_PreferencesOption](_preferences.md#oh_preferencesoption) \* [OH_PreferencesOption_Create](_preferences.md#oh_preferencesoption_create) (void) | 创建一个Preferences配置选项的[OH_PreferencesOption](_preferences.md#oh_preferencesoption)实例对象以及指向它的指针。 当不再需要使用指针时，请使用[OH_PreferencesOption_Destroy](_preferences.md#oh_preferencesoption_destroy)销毁实例对象，否则会导致内存泄漏。 | 
| int [OH_PreferencesOption_SetFileName](_preferences.md#oh_preferencesoption_setfilename) ([OH_PreferencesOption](_preferences.md#oh_preferencesoption) \*option, const char \*fileName) | 设置Preferences配置选项[OH_PreferencesOption](_preferences.md#oh_preferencesoption)实例对象的文件名称。 | 
| int [OH_PreferencesOption_SetBundleName](_preferences.md#oh_preferencesoption_setbundlename) ([OH_PreferencesOption](_preferences.md#oh_preferencesoption) \*option, const char \*bundleName) | 设置Preferences配置选项[OH_PreferencesOption](_preferences.md#oh_preferencesoption)实例对象的包名称。 | 
| int [OH_PreferencesOption_SetDataGroupId](_preferences.md#oh_preferencesoption_setdatagroupid) ([OH_PreferencesOption](_preferences.md#oh_preferencesoption) \*option, const char \*dataGroupId) | 设置Preferences配置选项[OH_PreferencesOption](_preferences.md#oh_preferencesoption)实例对象的应用组ID。 | 
| int [OH_PreferencesOption_Destroy](_preferences.md#oh_preferencesoption_destroy) ([OH_PreferencesOption](_preferences.md#oh_preferencesoption) \*option) | 销毁Preferences配置选项[OH_PreferencesOption](_preferences.md#oh_preferencesoption)实例。 |