WcmSetProperty 関数 (wcmapi.h)
WcmSetProperty 関数は、WCM プロパティの値を設定します。
構文
DWORD WcmSetProperty(
[in, optional] const GUID *pInterface,
[in, optional] LPCWSTR strProfileName,
[in] WCM_PROPERTY Property,
void *pReserved,
[in] DWORD dwDataSize,
[in, optional] const BYTE *pbData
);
パラメーター
[in, optional] pInterface
型: const GUID*
設定するインターフェイス。 グローバル プロパティの場合、このパラメーターは NULL です。
[in, optional] strProfileName
種類: LPCWSTR
プロファイル名。
[in] Property
種類: WCM_PROPERTY
設定する WCM プロパティ。
pReserved
種類: PVOID
予約済み。
[in] dwDataSize
型: DWORD
新しいプロパティ値のサイズ。
[in, optional] pbData
型: const BYTE*
新しいプロパティ値。
戻り値
型: DWORD
成功した場合はERROR_SUCCESSを返し、それ以外の場合はエラー値を返します。
注釈
pbData パラメーターに格納されるデータの種類は、設定されているプロパティによって異なります。 次の表は、各プロパティのデータ型を示しています。
| プロパティ名 | データ型 |
|---|---|
| wcm_global_property_domain_policy | WCM_POLICY_VALUE |
| wcm_global_property_minimize_policy | WCM_POLICY_VALUE |
| wcm_global_property_roaming_policy | WCM_POLICY_VALUE |
| wcm_global_property_powermanagement_policy | WCM_POLICY_VALUE |
| wcm_intf_property_connection_cost | WCM_CONNECTION_COST_DATA |
| wcm_intf_property_dataplan_status | WCM_DATAPLAN_STATUS |
| wcm_intf_property_hotspot_profile | 可変長 XML 文字列。 詳細については、 HotSpotProfile スキーマ を参照してください。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wcmapi.h |
| Library | Wcmapi.lib |
| [DLL] | Wcmapi.dll |