INapSystemHealthValidationRequest::GetSoHRequest-Methode

Mit der INapSystemHealthValidationRequest::GetSoHRequest-Methode können System Health Validators (SHVs) die SoHRequest-Informationen abrufen und überprüfen, die von ihren System Health Agent -Gegenstücken (SHA) auf dem Client gesendet wurden.

Syntax

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

Parameter

sohRequest [out]

Ein Zeiger auf einen Zeiger auf eine SoHRequest-Struktur .

napSystemGenerated [out]

Ein BOOL , der TRUE ist, wenn der SoH vom NapAgent im Namen des SHA erstellt wurde, andernfalls FALSE . Es wird in erster Linie verwendet, um einen SHA-Fehler für den SHV anzuzeigen.

Rückgabewert

Es können auch andere COM-spezifische Fehlercodes zurückgegeben werden.

Bemerkungen

Der sohRequest-Parameter gibt möglicherweise NULL zurück, wenn der Client keine SoHRequest an den SHV gesendet hat. In diesem Szenario kann der SHV eine SoHResponse mit dem Fehlercode von NAP_E_MISSING_SOH auffüllen.

Wenn der napSystemGenerated-ParameterTRUE ist, lautet das Format von SoHRequest wie folgt:

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

Anforderungen

Weitere Informationen

INapSystemHealthValidationRequest