Системная информация. Информация о среде выполнения процесса, страница 2

Функция

Назначение

DnsHostnameToCompulerName

Преобразует имя компьютера из формата DNS в формат NetBIOS

ExpandEnvironmentStrings

Расширяет строки переменных окружения и заменяет их определенными значениями

GetCommandLine

Возвращает командную строку процесса

GetComputerName

Осуществляет выборку имени компьютера в системе

GetComputerNameEx

Осуществляет выборку имени NetBIOS или DNS, которое связано с локальным компьютером

GetCurrentDirectory

Осуществляет выборку текущего каталога

GetDiskFreeSpaceEx

Осуществляет выборку информации о доступном пространстве на дисковом томе

GetDriveType

Возвращает тип физического носителя, связанного с логическим именем пути

GetEnvironmentStrings

Возвращает указатель на список строк окружения

GetEnvironmentVariable

Осуществляет выборку значения данной переменной окружения

GetLocalTime

Осуществляет выборку местного времени

GetLogicalDrives

Возвращает битовую маску доступных в настоящий момент накопителей

GetLogicalDriveStrings

Возвращает буфер со строками, в которых перечисляются действительные накопители, установленные в системе

GetStartuplnfo

Осуществляет выборку информации запуска данного процесса

GetSysColor

Возвращает  RGB-цвет, назначенный для данного системного цвета

GetSystemDefaultLangID

Возвращает идентификатор языка, характерный для региональной установки, используемой в системе по умолчанию

GetSystemDefaultLCID

Возвращает идентификатор региональной установки, используемой в системе по умолчанию

GetSystemDirectory

Осуществляет выборку имени системного каталога Windows

GetSystemlnfo

Осуществляет выборку информации об аппаратных средствах, установленных в системе

GetSystemPowerStatus

Осуществляет выборку информации о текущем состоянии энергоснабжения системы

GetSystemTime

Осуществляет выборку системного времени (в формате  UTC)

GetSystemWindowsDirectory

Осуществляет выборку системного каталога Windows в многопользовательской системе

GetTimeZonelnformation

Осуществляет выборку информации о временном поясе

GetUserDefaultLangID

Возвращает идентификатор языка, характерный для используемой по умолчанию региональной установки текущего пользователя

GetUserDefaultLCID

Возвращает идентификатор используемой по умолчанию региональной установки текущего пользователя

GetUserName

Осуществляет выборку имени пользователя текущего процесса

GetUserName

Осуществляет выборку имени пользователя текущего процесса в указанном формате

GetVersionEx

Осуществляет выборку максимального объема информации об используемой версии системы

GetVolumelnformation

Возвращает информацию от томе и установленной файловой системе

GetWindowsDirectory

Возвращает имя каталога, в котором установлена Windows

SetComputerName

Изменяет наименование системы при ее перезапуске

SetCompuferNameEx

Устанавливает имя  NetBIOS или DNS локального компьютера

SetCurrentDirectory

Изменяет текущий каталог

SetEnvironmentVariable

Изменяет параметр настройки переменной окружения

SetLocalTime

Изменяет время с учетом местного времени

SetSysColors

Изменяет  RGB-значения, назначенные для системных цветов

SetSystemPowerState

Переводит систему в экономичный режим

SetSystemTime

Изменяет время с учетом среднего времени по Гринвичу в формате  UTC                                                                            *''

SetTitneZonelnformation

Изменяет информацию о временном поясе

SetVolumeLabel

Устанавливает наименование тома

SystemParameterslnfo

Допускает выборку или установку параметров системы

TranslateName

Преобразует имя объекта службы каталогов из одного формата в другой

VerifyVersionlnfo

Проверяет информацию о версии системы с учетом конкретных требований

VerLanguageName

Возвращает название языка из идентификатора языка

DnsHostnameToComputerName          + Windows 98   * Windows 2000

Описание

Функция DnsHostnameToComputerName выполняет преобразование имени хоста в формате DNS в имя компьютера в формате NetBIOS. Эта функция реализует текстовое отображение имени. Указанное обстоятельство накладывает ограничение на имена компьютеров, которые должны составлять общепринятое подмножество имен. Эту функцию не следует использовать для преобразования доменного имени DNS в доменное имя NetBIOS.

Синтаксис

BOOL DnsHostnameToComputerName(LPTSTR   IpHostName,  LPTSTR IpComputerName, LPDWORD IpdwSize)

Параметры

IpHostName

LPTSTR: Указатель на строку, в которой задается имя DNS. Если DNS оказывается недействительным преобразуемым именем, рассматриваемая функция не может быть выполнена.

lpComputerName

LPTSTR: Указатель на строковый буфер, в который поступает имя компьютера. Размер этого буфера должен быть достаточно велик, чтобы вместить MAX_COMPUTER_LENGTH + 1 символов.

IpdwSize

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

Возвращаемое значение

BOOL: Если выполнение рассматриваемой функции оказывается успешным, возвращается ненулевое значение. В противном случае возвращается кулевое значение. Функция GetLastError вернет значение ERROR_BUFFER_OVER-FLOW, если размер указанного буфера окажется слишком мал.

Включаемый файл

winbase.h

См. также

GetComputerNameEx, SetComputerNameEx

ExpandEnvironmentStrinqs               • Windows 98   • Windows 2000

Описание

Функция ExpandEnvironmentStrings разворачивает строки переменных окружения и заменяет их определенными для них значениями. Так, часть %VariabIeName% ссылки на каждую переменную заменяется текущим значением данной переменной окружения. Правила замены в данном случае подобны правилам, применяемым в интерпретаторе команд. Замена выполняется без учета регистра, и если имя переменной не будет найдено, тогда переменная остается без изменения.

Синтаксис

DWORD ExpandEmironmentStrings(LPCTSTR IpSrc, LPTSTR IpDst, DWORD nSize)

Параметры

IpSrc

LPCTSTR Указатель на строку, завершающуюся нулевым символом и содержащую строку окружения, в которую могут входить строки отдельных переменных окружения.

IpDst

LPTSTR: Указатель на буфер, в который поступает копия исходного буфера после выполнения замен всех имен переменных окружения.

nSize

DWORD: Максимальное количество символов, сохраняемых в буфере, на который указывает параметр IpDst. В это число входит и завершающий нулевой символ.

Возвращаемое значение

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

Включаемый файл

winbase.h

См. также

GetEnvironmentStrings, GetEnvironmentVariable

Пример

В приведенном ниже примере выполняется разворачивание переменной %systemroot% внутри указанного пути до конкретного значения, когда пользователь выбирает пункт меню Test! Новое значение отображается в окне сообщения.

См.    \local-sources\chap21\21-01. txt

GetCommandLine                          • Windows 98   • Windows 2000

Описание

Функция GetCommandLine возвращает командную строку процесса. Эта командная строка представляет собой строку, завершающуюся нулевым символом и относящуюся к одному из параметров, указываемых при вызове функции CreateProcess, которая запускает процесс.

Синтаксис

LPTSTR GetCommandLine(VOID)