> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblLocalStorageWriteHandler

> XblLocalStorageWriteHandler

# XblLocalStorageWriteHandler

由 XSAPI 调用以请求客户端执行本地存储写入操作。

## 语法

```cpp theme={null}
void XblLocalStorageWriteHandler(  
         void* context,  
         XblClientOperationHandle operation,  
         XblUserHandle user,  
         XblLocalStorageWriteMode mode,  
         char key,  
         size_t dataSize,  
         void data  
)  
```

### 参数

*context*   \_In\_opt\_\
类型：void\*

指向事件处理程序所使用数据的可选指针。

*operation*   \_In\_\
类型：[XblClientOperationHandle](/reference/live/xsapi-c/platform_c/handles/xblclientoperationhandle)

此操作的句柄。

*user*   \_In\_\
类型：XblUserHandle

正在为其写入数据的用户。

*mode*   \_In\_\
类型：[XblLocalStorageWriteMode](/reference/live/xsapi-c/platform_c/enums/xbllocalstoragewritemode)

用于写入操作的模式。

*key*   \_In\_z\_\
类型：char

标识正在写入的数据。

*dataSize*   \_In\_\
类型：size\_t

数据的大小（以字节为单位）。

*data*   \_In\_reads\_bytes\_(dataSize)\
类型：void

要写入的数据。

### 返回值

类型：void

## 备注

操作完成后，应调用 XblLocalStorageWriteComplete。除 context 外，所有参数均由 XSAPI 拥有，并保证在操作完成之前有效。

## 要求

**头文件：** platform\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[platform\_c](/reference/live/xsapi-c/platform_c/platform_c_members)


## Related topics

- [XblLocalStorageWriteComplete](/zh-CN/reference/live/xsapi-c/platform_c/functions/xbllocalstoragewritecomplete.md)
- [XblLocalStorageSetHandlers](/zh-CN/reference/live/xsapi-c/platform_c/functions/xbllocalstoragesethandlers.md)
- [XblLocalStorageClearHandler](/zh-CN/reference/live/xsapi-c/platform_c/functions/xbllocalstorageclearhandler.md)
- [XblLocalStorageReadHandler](/zh-CN/reference/live/xsapi-c/platform_c/functions/xbllocalstoragereadhandler.md)
- [XblLocalStorageWriteMode](/zh-CN/reference/live/xsapi-c/platform_c/enums/xbllocalstoragewritemode.md)