---
title: "ksChoiceFileW - Выдать диалог выбора файла для чтения (Unicode)"
type: guide
api: [api7]
tags: [guide, api7, kschoicefilew]
sources:
  - kschoicefilew.html
---

*API экспортных функций > Функции работы с файлами документов *

Аналог данной функции при использовании Automation - метод KompasObject::ksChoiceFile
Синтаксис:
```
unsigned int LIB_FUNK ksChoiceFileW (LPWSTR ext,
LPWSTR filter,
LPWSTR name,
unsigned int bufLen,
unsigned char preview);
Входные параметры:
Ext    - расширение имени файла,
Filter    - фильтр поиска (0 - формируется автоматически),
Preview    - признак подключения окна предварительного просмотра: 1 - с подключением окна, 0 - без подключения окна.
Выходные параметры:
name    - буфер для имени файла,
bufLen    - длина отведенного буфера для name в символах.
Возвращаемое значение:
требуемая длина буфера в символах    - в случае удачного завершения,
NULL    - в случае отказа от выбора.
```
Примечание:
1. Если размер отведенного буфера bufLen меньше требуемой длины - имя файла не заполняется. В этом случае имя файла можно получить функцией GetRightFileName.
2. При использовании ANSI следует использовать функцию ksChoiceFile.
