wlanapi.h (wlanSaveTemporaryProfile 函数)
WlanSaveTemporaryProfile 函数将临时配置文件保存到配置文件存储中。
语法
DWORD WlanSaveTemporaryProfile(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] LPCWSTR strProfileName,
[in, optional] LPCWSTR strAllUserProfileSecurity,
[in] DWORD dwFlags,
[in] BOOL bOverWrite,
PVOID pReserved
);
参数
[in] hClientHandle
客户端的会话句柄，由先前对 WlanOpenHandle 函数的调用获取。
[in] pInterfaceGuid
接口的 GUID。
[in] strProfileName
要保存的配置文件的名称。 配置文件名称区分大小写。 此字符串必须以 NULL 结尾。
[in, optional] strAllUserProfileSecurity
在所有用户配置文件上设置安全描述符字符串。 默认情况下，对于新的所有用户配置文件，所有用户都对该配置文件具有写入访问权限。 有关配置文件权限的详细信息，请参阅“备注”部分。
如果 dwFlags 设置为 WLAN_PROFILE_USER，则忽略此参数。
如果对于所有用户配置文件，此参数设置为 NULL ，则使用默认权限。
如果此参数对于所有用户配置文件不为 NULL ，则会在创建安全描述符对象并将其分析为字符串后，创建或修改与该配置文件关联的安全描述符字符串。
[in] dwFlags
指定要在配置文件上设置的标志。 可以组合这些标志。
| 值 | 含义 |
|---|---|
|
配置文件是一个全用户配置文件。 |
|
配置文件是每用户配置文件。 |
|
配置文件由客户端创建。 |
|
配置文件由自动配置模块创建。 |
[in] bOverWrite
指定此配置文件是否覆盖现有配置文件。 如果此参数为 FALSE 且配置文件已存在，则不会覆盖现有配置文件，并且将返回错误。
pReserved
保留供将来使用。 必须设置为 NULL。
返回值
如果函数成功，则返回值为 ERROR_SUCCESS。
如果函数失败，则返回值可能是以下返回代码之一。
| 返回代码 | 说明 |
|---|---|
|
出现以下情况之一：
|
|
在句柄表中找不到句柄 hClientHandle 。 |
|
此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数，则将返回此值。 |
|
各种错误代码。 |
|
接口当前未使用临时配置文件进行连接。 |
注解
临时配置文件是传递给 WlanConnect 或由发现引擎生成的配置文件。 可以使用临时配置文件建立网络连接。 使用此 API 会将临时配置文件和关联的用户数据保存到配置文件存储中。
新配置文件将添加到列表顶部的组策略配置文件后面。 如果覆盖现有配置文件，则配置文件在列表中的位置不会更改。
所有用户配置文件具有三个关联的权限：读取、写入和执行。 如果用户具有读取访问权限，则用户可以查看配置文件权限。 如果用户具有执行访问权限，则用户具有读取访问权限，并且用户也可以使用配置文件连接到网络并断开其连接。 如果用户具有写入访问权限，则用户具有执行访问权限，并且用户还可以修改和删除与配置文件关联的权限。
下面介绍了创建安全描述符对象并将其分析为字符串的过程。
- 调用 InitializeSecurityDescriptor 以在内存中创建安全描述符。
- 调用 SetSecurityDescriptorOwner。
- 调用 InitializeAcl 以在内存中创建自由访问控制列表 (DACL) 。
- 调用 AddAccessAllowedAce 或 AddAccessDeniedAce (ACE) 添加到 DACL。 根据需要将 AccessMask 参数设置为以下按位 OR 组合之一：
- WLAN_READ_ACCESS
- WLAN_READ_ACCESS |WLAN_EXECUTE_ACCESS
- WLAN_READ_ACCESS |WLAN_EXECUTE_ACCESS |WLAN_WRITE_ACCESS
- 调用 SetSecurityDescriptorDacl 将 DACL 添加到安全描述符。
- 调用 ConvertSecurityDescriptorToStringSecurityDescriptor 将描述符转换为字符串。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wlanapi.h (包括 Wlanapi.h) |
| Library | Wlanapi.lib |
| DLL | Wlanapi.dll |