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 | Скачать

GetCurrentHwProfile

[New - Windows NT]

The GetCurrentHwProfile function retrieves information about the current hardware profile for the local computer.

BOOL GetCurrentHwProfile(

LPHW_PROFILE_INFO lpHwProfileInfo // receives the hardware profile information
);

Parameters

lpHwProfileInfo

Pointer to an HW_PROFILE_INFO structure in which the function returns information about the current hardware profile.

Return Values

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

Remarks

The GetCurrentHwProfile function retrieves the display name and globally unique identifier (GUID) string for the hardware profile. The function also retrieves the reported docking state for portable computers with docking stations.
The system generates a GUID for each hardware profile and stores it as a string in the registry. You can use GetCurrentHwProfile to retrieve the GUID string to use as a registry subkey under your application's configuration settings key in HKEY_CURRENT_USER. This enables you to store each user's settings for each hardware profile. For example, the Colors control panel application could use the subkey to store each user's color preferences for different hardware profiles, such as profiles for the docked and undocked states. Applications that use this functionality can check the current hardware profile when they start up, and update their settings accordingly.

Windows 95: Applications can also update their settings when a system device message, such as DBT_CONFIGCHANGED, indicates that the hardware profile has changed.

Example

#include
#include
#include

void main(void) {
HW_PROFILE_INFO HwProfInfo;

if (!GetCurrentHwProfile(&HwProfInfo)) {
_tprintf(TEXT("GetCurrentHwProfile failed with error %lx\n"),
GetLastError());
return;
}

_tprintf(TEXT("DockInfo = %d\n"), HwProfInfo.dwDockInfo);
_tprintf(TEXT("Profile Guid = %s\n"), HwProfInfo.szHwProfileGuid);
_tprintf(TEXT("Friendly Name = %s\n"), HwProfInfo.szHwProfileName);

} // main

See Also

DBT_CONFIGCHANGED, HW_PROFILE_INFO

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetCurrentHwProfile

[Новый - Windows NT]

Функция GetCurrentHwProfile извлекает информацию о текущем аппаратном профиле для локального компьютера.

BOOL GetCurrentHwProfile(

приемники LPHW_PROFILE_INFO lpHwProfileInfo // аппаратная информация профиля
);

Параметры

lpHwProfileInfo

Указатель в структуру HW_PROFILE_INFO в котором функция возвращает информацию о текущем аппаратном профиле.

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

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

Замечания

Функция GetCurrentHwProfile извлекает дисплейное имя и глобально уникальный идентификатор (GUID) строку для аппаратного профиля. Функция также извлекает зарегистрированную постановку в док состояния для портативных компьютеров с постановкой в док станций.
Система генерирует GUID для каждого аппаратного профиля и загрузки это как строка в регистрации. Вы можете использовать GetCurrentHwProfile, чтобы извлекать строку GUID, чтобы использовать как подключ регистрации под вашей клавишей установочных параметров прикладной конфигурации в HKEY_CURRENT_USER. Это позволяет Вам, чтобы загружать каждые установочные параметры пользователя для каждого аппаратного профиля. Например, панель управления приложения Цветов могла бы использовать подключ, чтобы загружать каждые цветные предпочтения пользователя для других аппаратных профилей, как например, профили для причаленного и undocked состояний. Приложения, которые используют это функциональное назначение может проверить текущий аппаратный профиль когда они запускают, и корректируют свои установочные параметры соответственно.

Windows 95: Приложения могут также скорректировать их установочные параметры когда системное сообщение устройства, как например, DBT_CONFIGCHANGED, указывает, что аппаратный профиль изменил.

Пример

#include #include #include

недействительная основа(пустота) { HW_PROFILE_INFO HwProfInfo;

если (!GetCurrentHwProfile(&HwProfInfo)) { _tprintf(TEXT("GetCurrentHwProfile ПОТЕРПЕВШЕЕ неудачу ошибкой %lx\n"), GetLastError());
возврат;
}

_tprintf(TEXT("DockInfo = %d\n"), HwProfInfo.dwDockInfo);
_tprintf(TEXT("Profile Guid = %s\n"), HwProfInfo.szHwProfileGuid);
_tprintf(TEXT("Friendly Называть = %s\n"), HwProfInfo.szHwProfileName);

} // основа

Смотри Также

DBT_CONFIGCHANGED, HW_PROFILE_INFO

Используются технологии uCoz