На главную

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

GetWindowsDirectory



The GetWindowsDirectory function retrieves the path of the Windows directory. The Windows directory contains such files as Windows-based applications, initialization files, and Help files.

UINT GetWindowsDirectory(

LPTSTR lpBuffer, // address of buffer for Windows directory
UINT uSize // size of directory buffer
);


Parameters

lpBuffer

Points to the buffer to receive the null-terminated string containing the path. This path does not end with a backslash unless the Windows directory is the root directory. For example, if the Windows directory is named WINDOWS on drive C, the path of the Windows directory retrieved by this function is C:\WINDOWS. If Windows was installed in the root directory of drive C, the path retrieved is C:\.

uSize

Specifies the maximum size, in characters, of the buffer specified by the lpBuffer parameter. This value should be set to at least MAX_PATH to allow sufficient room in the buffer for the path.



Return Values

If the function succeeds, the return value is the length, in characters, of the string copied to the buffer, not including the terminating null character.
If the length is greater than the size of the buffer, the return value is the size of the buffer required to hold the path.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The Windows directory is the directory where an application should store initialization and help files. If the user is running a shared version of Windows, the Windows directory is guaranteed to be private for each user.
If an application creates other files that it wants to store on a per-user basis, it should place them in the directory specified by the HOMEPATH environment variable. This directory will be different for each user, if so specified by an administrator, via the User Manager administrative tool. HOMEPATH always specifies either the user's home directory, which is guaranteed to be private for each user, or a default directory (for example, C:\USERS\DEFAULT) where the user will have all access.

See Also

GetCurrentDirectory, GetSystemDirectory


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

GetWindowsDirectory



Функция GetWindowsDirectory извлекает путь директория Окна. Директорий Окна содержит такие файлы как основано приложения Окна, файлов инициализации, и файлы Помощи.

UINT GetWindowsDirectory(

LPTSTR lpBuffer, // АДРЕС буфера для директория Окна UINT uSize // размер буфера директория
);


Параметры

lpBuffer

Точки на буфер, чтобы получать недействительный расторгнутую строку, содержащую путь. Этот путь не заканчивается с обратной косой чертой если директорий Окна не является корневым директорием. Например, если директорий Окна назван ОКНО в проезде C, путь директория Окна извлеченного этой функцией - C:\WINDOWS. Если Окно было установлено в корневом директории проезда C, извлеченный путь - C:\.

uSize

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



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

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

Замечания

Директорий Windows является директорием где приложение должно загружать инициализацию и помогать файлам. Если пользователь выполняет коллективную версию Windows, директорий Windows гарантирован, чтобы быть частным для каждого пользователя.
Если приложение создает другие файлы, которые он хочет загружаться на per-основу пользователя, это должно устанавливать им в директории определенном переменной среды HOMEPATH. Этот директорий будет другим для каждого пользователя, если так определенное администратором, через Менеджера Пользователя административного средства. HOMEPATH ВСЕГДА определяет также домашний директорий пользователя, который гарантирован, чтобы быть частным для каждого пользователя, или по умолчанию директория (например, C:\USERS\DEFAULT) где пользователь будет иметь весь доступ.

Смотри Также

GetCurrentDirectory, GetSystemDirectory


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