INapSystemHealthValidationRequest::GetSoHRequest メソッド

Note

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

INapSystemHealthValidationRequest::GetSoHRequest メソッドを使用すると、System Health Validators (SHV) は、クライアント上の対応する System Health Agent (SHA) によって送信された SoHRequest 情報を取得および検証できます。

構文

HRESULT GetSoHRequest(
  [out] SoHRequest **sohRequest,
  [out] BOOL       *napSystemGenerated
);

パラメーター

sohRequest [out]

SoHRequest 構造体へのポインターへのポインター。

napSystemGenerated [out]

SOH が SHA の代わりに NapAgent によって作成された場合は TRUE、それ以外の場合は FALSE である BOOL。 これは主に、SHV に対する SHA エラーを示すために使用されます。

戻り値

他の COM 固有のエラー コードも返される場合があります。

リターン コード	説明
S_OK	操作に成功しました。
E_ACCESSDENIED	アクセス許可エラー、アクセスが拒否されました。
E_OUTOFMEMORY	システム リソースの制限。操作を実行できませんでした。

解説

クライアントが SHV に SoHRequest を送信しなかった場合、sohRequest パラメーターは NULL を返す可能性があります。 そのシナリオでは、SHV は SoHResponse に NAP_E_MISSING_SOHのエラー コードを設定できます。

napSystemGenerated パラメーターが TRUE の場合、SoHRequest の形式は次のようになります。

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = <sha-failure-error-code>

要件

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

関連項目

INapSystemHealthValidationRequest