|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
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
|
|
|
|
| |