HW_PROFILE_INFOA構造体 (winbase.h)

  • [アーティクル]

ハードウェア プロファイルに関する情報が含まれます。 GetCurrentHwProfile 関数は、この構造体を使用して、ローカル コンピューターの現在のハードウェア プロファイルを取得します。

構文

typedef struct tagHW_PROFILE_INFOA {
  DWORD dwDockInfo;
  CHAR  szHwProfileGuid[HW_PROFILE_GUIDLEN];
  CHAR  szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOA, *LPHW_PROFILE_INFOA;

メンバー

dwDockInfo

コンピューターの報告されたドッキング状態。 このメンバーは、次のビット値の組み合わせにすることができます。

値 意味
DOCKINFO_DOCKED
0x2
 コンピューターがドッキングされています。
DOCKINFO_UNDOCKED
0x1
 コンピューターがドッキング解除されています。 このフラグは、ドッキング解除できないデスクトップ システムに対して常に設定されます。
DOCKINFO_USER_SUPPLIED
0x4
 このフラグが設定されている場合、GetCurrentHwProfile は、システム コントロール パネル アプリケーションの [ハードウェア プロファイル] ページでユーザーが提供した情報から現在のドッキング状態を取得します。

このような値がない場合、または値が 0 に設定されている場合は、このフラグが設定されます。
DOCKINFO_USER_DOCKED
0x5
 ユーザーが提供する情報に従って、コンピューターがドッキングされます。 この値は、DOCKINFO_USER_SUPPLIEDフラグとDOCKINFO_DOCKED フラグの組み合わせです。
DOCKINFO_USER_UNDOCKED
0x6
 ユーザーが提供する情報に従って、コンピューターがドッキング解除されます。 この値は、DOCKINFO_USER_SUPPLIEDフラグとDOCKINFO_UNDOCKED フラグの組み合わせです。

szHwProfileGuid[HW_PROFILE_GUIDLEN]

現在のハードウェア プロファイルのグローバル一意識別子 (GUID) 文字列。 GetCurrentHwProfile によって返される文字列は、{}GUID を中かっこで囲みます。次に例を示します。

{12340001-4980-1920-6788-123456789012}

この文字列は、 HKEY_CURRENT_USERのアプリケーションの構成設定キーの下のレジストリ サブキーとして使用できます。 これにより、各ハードウェア プロファイルの設定を格納できます。

szHwProfileName[MAX_PROFILE_LEN]

現在のハードウェア プロファイルの表示名。

注釈

注意

winbase.h ヘッダーは、HW_PROFILE_INFOをエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header winbase.h (Windows.h を含む)

こちらもご覧ください

GetCurrentHwProfile