次の方法で共有

HW_PROFILE_INFOW 構造体 (winbase.h)

  • [アーティクル]

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

構文

typedef struct tagHW_PROFILE_INFOW {
  DWORD dwDockInfo;
  WCHAR szHwProfileGuid[HW_PROFILE_GUIDLEN];
  WCHAR szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOW, *LPHW_PROFILE_INFOW;

メンバー

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

要件

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

こちらもご覧ください

GetCurrentHwProfile