На главную

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 | Скачать Вниз

DefineDosDevice



The DefineDosDevice function lets an application define, redefine, or delete MS-DOS device names.

MS-DOS device names are stored as symbolic links in the object name space in 32-bit versions of Windows. The code that converts an MS-DOS path into a corresponding path in 32-bit versions of Windows uses these symbolic links to map MS-DOS devices and drive letters. The DefineDosDevice function provides a mechanism whereby a Win32-based application can modify the symbolic links used to implement the MS-DOS device name space.

BOOL DefineDosDevice(

DWORD dwFlags, // flags specifying aspects of device definition
LPCTSTR lpDeviceName, // pointer to MS-DOS device name string
LPCTSTR lpTargetPath // pointer to MS-DOS or path string for 32-bit Windows
);


Parameters

dwFlags

Specifies several controllable aspects of the DefineDosDevice function. One or more of the following values can be used:

Value Meaning
DDD_RAW_TARGET_PATH If this value is specified, the function does not convert the lpTargetPath string from an MS-DOS path to a path for a 32-bit version of Windows, but takes it as is.
DDD_REMOVE_DEFINITION If this value is specified, the function removes the specified definition for the specified device. To determine which definition to remove, the function walks the list of mappings for the device, looking for a match of lpTargetPath against a prefix of each mapping associated with this device. The first mapping that matches is the one removed, and then the function returns.If lpTargetPath is NULL or a pointer to a NULL string, the function will remove the first mapping associated with the device and pop the most recent one pushed. If there is nothing left to pop, the device name will be removed.If this value is NOT specified, the string pointed to by the lpTargetPath parameter will become the new mapping for this device.
DDD_EXACT_MATCH_ON_REMOVE If this value is specified along with DDD_REMOVE_DEFINITION, the function will use an exact match to determine which mapping to remove. Use this value to insure that you do not delete something that you did not define.


lpDeviceName

Points to an MS-DOS device name string specifying the device the function is defining, redefining, or deleting. The device name string must not have a trailing colon, unless a drive letter (C or D, for example) is being defined, redefined, or deleted.

lpTargetPath

Points to a path string that will implement this device. Points to an MS-DOS path string unless the DDD_RAW_TARGET_PATH flag is specified, in which case this parameter points to a path string for a 32-bit version of Windows.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

As stated in this function's introductory summary, 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. To retrieve the current mapping for a particular MS-DOS device name or to obtain a list of all MS-DOS devices known to the system, use the QueryDosDevice function.
MS-DOS Device names are global. Once defined, an MS-DOS device name remains visible to all processes until either it is explicitly removed or the system reboots.

Note that drive letters and device names defined at system boot time are protected from redefinition and deletion unless a user is running in administrative mode (ADMIN).

See Also

QueryDosDevice


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

DefineDosDevice



Функция DefineDosDevice позволяет, приложение определяет, переопределяет, или удаляет имена устройства МС-DOS.

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

BOOL DefineDosDevice(

DWORD dwFlags, // ФЛАГИ, определяющие аспекты определения устройства LPCTSTR lpDeviceName, // указателя в строку имени устройства МС-DOS указателя LPCTSTR lpTargetPath // в МС-DOS или строку пути для 32- битового Окна
);


Параметры

dwFlags

Определяет несколько управляемых аспектов функции DefineDosDevice. Одно или более из следующего величин могут быть использованы:

Значение Величины
DDD_RAW_TARGET_PATH Если эта величина определена, функция не преобразовывает строку lpTargetPath от пути МС-DOS до пути для 32- битовой версии Окна но выбирает это как есть.
DDD_REMOVE_DEFINITION Если эта величина определена, функция удаляет определенное определение для определенного устройства. Для того, чтобы определять какое определение, чтобы удалять, функция проходит список распределений для устройства, ищущая спичка lpTargetPath против префикса каждого распределения связывалась этим устройством. Сначала отображая эти спички - один удаленное, и затем функциональный возврат.Если lpTargetPath - НЕДЕЙСТВИТЕЛЬНЫЙ или указатель в НЕДЕЙСТВИТЕЛЬНОЙ строке, функция удалит первое распределение связанное устройством и выталкивает наиболее последний вытолкнутый. Если есть ничто оставленное, чтобы выталкиваться, имя устройства будет удалено.Если эта величина НЕ определена, строка указанная, чтобы параметром lpTargetPath станет новым распределением для этого устройства.
DDD_EXACT_MATCH_ON_REMOVE Если эта величина определена вместе с DDD_REMOVE_DEFINITION, функция использует точную спичку, чтобы определять какое распределение, чтобы удалять. Используйте эту величину, чтобы страховать, чтобы Вы не удаляли чему-то, что Вы не определяли.


lpDeviceName

Точки на строку имени устройства МС-DOS, определяющие устройство функция определяется, переопределение, или удалять. Строка имени устройства не должна иметь конечное двоеточие, если письмо проезда (C или D, например), не определяется, переопределяет, или удаляется.

lpTargetPath

Точки на строку пути, что осуществит это устройство. Точки на строку пути МС-DOS если флаг DDD_RAW_TARGET_PATH не определен, в этом случае этот параметр указывает на строку пути для 32- битовой версии Окна.



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

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

Замечания

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

Отметьте, что обозначения накопителей и имена устройства определялись в системном времени загрузки защищены из повторного определения и удаления если пользователь не работает в административном режиме (АДМИНИСТРАЦИЯ).

Смотри Также

QueryDosDevice


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