На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

QueryDosDevice



The QueryDosDevice function lets an application obtain information about MS-DOS device names. The function can obtain the current mapping for a particular MS-DOS device name. The function can also obtain a list of all existing MS-DOS device names.

MS-DOS device names are stored as symbolic links in the Windows NT object name space. The code that converts an MS-DOS path into a corresponding Windows NT path uses these symbolic links to map MS-DOS devices and drive letters. The QueryDosDevice function provides a mechanism whereby a Win32-based application can query the names of the symbolic links used to implement the MS-DOS device namespace as well as the value of each specific symbolic link.

DWORD QueryDosDevice(

LPCTSTR lpDeviceName, // address of MS-DOS device name string
LPTSTR lpTargetPath, // address of buffer for storing query results
DWORD ucchMax // maximum storage capacity of buffer
);


Parameters

lpDeviceName

Pointer to an MS-DOS device name string specifying the target of the query.
This parameter can be NULL. In that case, the QueryDosDevice function will store a list of all existing MS-DOS device names into the buffer pointed to by lpTargetPath.

lpTargetPath

Pointer to a buffer that will receive the result of the query. The function fills this buffer with one or more null-terminated strings. The final null-terminated string is followed by an additional NULL.
If lpDeviceName is non-NULL, the function obtains information about the particular MS-DOS device specified by lpDeviceName. The first null-terminated string stored into the buffer is the current mapping for the device. The other null-terminated strings represent undeleted prior mappings for the device.

If lpDeviceName is NULL, the function obtains a list of all existing MS-DOS device names. Each null-terminated string stored into the buffer is the name of an existing MS-DOS device.

ucchMax

Specifies the maximum number of characters that can be stored into the buffer pointed to by lpTargetPath.



Return Values

If the function succeeds, the return value is the number of characters stored into the buffer pointed to by lpTargetPath.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The DefineDosDevice function provides a means whereby a Win32-based application can create and modify the symbolic links used to implement the MS-DOS device namespace.
MS-DOS device names are global. Once defined, an MS-DOS device name remains visible to all processes until either it is explicity removed or the system reboots.

See Also

DefineDosDevice


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

QueryDosDevice



Функция QueryDosDevice позволяет, приложение получает информацию об именах устройства МС-DOS. Функция может получить течение, отображающееся для конкретного имени устройства МС-DOS. Функция может также получить список всех, существующий имена устройства МС-DOS.

ИМЕНА устройства МС-DOS загружены как символический включается объектное пространство имени Windows NT. Код, который преобразовывает путь МС-DOS в, соответствующему пути Windows NT использует эти символические связи, чтобы отображать устройства МС-DOS и обозначения накопителей. Функция QueryDosDevice обеспечивает механизм, посредством чего базирующееся приложение Win32 может запрос имена символических связей использованных, чтобы осуществлять устройство МС-DOS namespace, а также величина каждой специфической символической связи.

DWORD QueryDosDevice(

LPCTSTR lpDeviceName, // АДРЕС строки имени устройства МС-DOS LPTSTR lpTargetPath, // адрес буфера для хранения запроса происходит максимальную возможность памяти DWORD ucchMax // буфера
);


Параметры

lpDeviceName

Указатель в строку имени устройства МС-DOS, определяющую объект запроса.
Этот параметр может быть НЕДЕЙСТВИТЕЛЕН. В этом случае, функция QueryDosDevice загрузит список всех, существующий устройство МС-DOS называется в буфер указанный, чтобы lpTargetPath.

lpTargetPath

Указатель в буфер, который получит результат запроса. Функция заполняет этот буфер одним или более недействительный расторгнутыми строками. Недействительный расторгнутая строка финала следует за дополнительным НЕДЕЙСТВИТЕЛЬНЫМ.
Если lpDeviceName не-НЕДЕЙСТВИТЕЛЕН, функция получает информацию о конкретном устройстве МС-DOS определенном lpDeviceName. Первая недействительный расторгнутая строка загруженная в буфер - течение, отображающееся для устройства. Другие недействительный расторгнутые строки представляют восстановленные предшествующие распределения для устройства.

Если lpDeviceName НЕДЕЙСТВИТЕЛЕН, функция получает список всех, существующий имена устройства МС-DOS. Каждая недействительный расторгнутая строка загруженная в буфер - имя, существующее устройство МС-DOS.

ucchMax

Определяет максимальное количество символов, которые могут быть загружены в буфер указанный, чтобы lpTargetPath.



Обратные Величины

Если функция добивается успеха, обратная величина является количеством символов загруженных в буфер указанный, чтобы lpTargetPath.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Функция DefineDosDevice обеспечивает средства, посредством чего базирующееся приложение Win32 может создать и модифицировать символические связи использованные, чтобы осуществлять устройство МС-DOS namespace.
ИМЕНА устройства МС-DOS глобальные. Как только определено, имя устройства МС-DOS остается видимым во все процессы до или это - explicity удаленный или системные перезагрузки.

Смотри Также

DefineDosDevice


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz