INapComponentConfig3::NewConfig メソッド

Note

ネットワークアクセス保護プラットフォームは、Windows 10 以降は使用できません

NewConfig メソッドは、特定の構成 ID の構成データを作成する方法を提供するために、システム正常性検証コントロール (SHV) によって実装されます。この関数が呼び出されると、SHV は新しい構成データを割り当て、既定の構成データのコピーを設定する必要があります。

構文

HRESULT NewConfig(
   UINT32 configID
);

configID: 構成を表す値。 ConfigID はネットワークポリシーサーバー (NPS) サービスによって割り当てられ、SHV 内で一意です。

この操作の結果に基づいて、次のいずれかのエラーコードを返します。

リターンコード	説明
S_OK	操作が成功しました。
E_INVALIDARG	ConfigID は 0 (既定の構成用に予約された値) です。
NAP_E_SHV_CONFIG_EXISTED	ConfigID は既に存在します。 NPS に認識される ID の一覧は、SHV とは異なります。

NewConfig によって新しい構成が作成されたら、GetConfigFromID、InvokeUIFromConfigBlob、および SetConfigToID メソッドを使用して、必要に応じて構成を変更する必要があります。

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
Header	NapCommon.h
IDL	NapCommon.idl