次の方法で共有

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 ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてHW_PROFILE_INFOを定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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

関連項目

GetCurrentHwProfile の