Метод IInitiateWinSATAssessment::InitiateFormalAssessment (winsatcominterfacei.h)

Статья
08/27/2023

[IInitiateWinSATAssessment::InitiateFormalAssessment может быть изменен или недоступен для выпусков после Windows 8.1.]

Инициирует официальную оценку.

Синтаксис

HRESULT InitiateFormalAssessment(
  [in, optional] IWinSATInitiateEvents *pCallbacks,
  [in, optional] HWND                  callerHwnd
);

Параметры

[in, optional] pCallbacks

Интерфейс IWinSATInitiateEvents , который реализуется для получения уведомлений о завершении оценки или ее выполнении. Если вы не хотите получать уведомления, может иметь значение NULL .

[in, optional] callerHwnd

Дескриптор окна клиента. Дескриптор используется для выравнивания диалоговых окон WinSAT. Если значение РАВНО NULL, диалоговые окна размещаются по центру рабочего стола.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

В следующей таблице перечислены некоторые значения HRESULT, возвращаемые этим методом.

Возвращаемый код или значение	Описание
S_OK	WinSAT успешно запущен. Чтобы определить, успешно ли выполнена оценка, реализуйте метод IWinSATInitiateEvents::WinSATComplete и проверка значение параметра hresult.
WINSAT_ERROR_WINSAT_DOES_NOT_EXIST 0x80040011	Не удалось найти программу WinSAT там, где ожидалось.

Обычно выполняется официальная оценка для оценки всех подкомпонентов компьютера, в то время как специальная оценка оценивает один подкомпонент компьютера. Чтобы выполнить специальную оценку, вызовите метод IInitiateWinSATAssessment::InitiateAssessment .

Чтобы получить результаты формальной оценки, используйте интерфейс IQueryRecentWinSATAssessment .

При вызове этой функции из приложения Windows реализуйте интерфейс IWinSATInitiateEvents , чтобы можно было отображать сведения о ходе выполнения и получать уведомления по завершении оценки. Для консольного приложения Windows отображение хода выполнения необязательно, так как WinSAT записывает сведения о ходе выполнения в окно консоли.

Обратите внимание, что для запуска WinSAT требуются права администратора. Если у пользователя нет прав администратора, WinSAT отобразит диалоговое окно с запросом учетных данных.

Примеры

В следующем примере показано, как выполнить официальную оценку и получить уведомление о ходе ее выполнения.

#include <windows.h>
#include <stdio.h>
#include <conio.h>  // For kbhit()
#include <winsatcominterfacei.h>

#pragma comment(lib, "ole32.lib")

// Class that implements IWinSATInitiateEvents. Implement this class to
// get progress information and completion notification.
class CWinSATCallbacks : public IWinSATInitiateEvents
{
    LONG m_lRefCount;

public:

    // Constructor, Destructor
    CWinSATCallbacks() {m_lRefCount = 1;};
    ~CWinSATCallbacks() {};

    // IUnknown methods
    HRESULT __stdcall QueryInterface(REFIID riid, LPVOID *ppvObj);
    ULONG __stdcall AddRef();
    ULONG __stdcall Release();

    // IWinSATInitiateEvents methods
    HRESULT __stdcall WinSATComplete(HRESULT hr, LPCWSTR description);
    HRESULT __stdcall WinSATUpdate(UINT currentTick, UINT tickTotal, LPCWSTR currentState);
};


HRESULT CWinSATCallbacks::QueryInterface(REFIID riid, LPVOID* ppvObj) 
{
    if (riid == __uuidof(IUnknown) || riid == __uuidof(IWinSATInitiateEvents)) 
    {
        *ppvObj = this;
    }
    else
    {
        *ppvObj = NULL;
        return E_NOINTERFACE;
    }

    AddRef();
    return NOERROR;
}

ULONG CWinSATCallbacks::AddRef() 
{
    return InterlockedIncrement(&m_lRefCount);
}

ULONG CWinSATCallbacks::Release() 
{
    ULONG  ulCount = InterlockedDecrement(&m_lRefCount);

    if(0 == ulCount) 
    {
        delete this;
    }

    return ulCount;
}

// Is called when WinSAT completes the assessment or an error occurs.
HRESULT CWinSATCallbacks::WinSATComplete(HRESULT hr, LPCWSTR description)
{
    if (SUCCEEDED(hr))
    {
        wprintf(L"\n*** %s", description);
    }
    else
    {
        wprintf(L"\n*** The assessment failed with 0x%x (%s)\n", hr, description);
    }

    return S_OK;
}

// Is called when the assessment makes progress. Indicates the percentage of the assessment
// that is complete and the current component being assessed.
HRESULT CWinSATCallbacks::WinSATUpdate(UINT currentTick, UINT tickTotal, LPCWSTR currentState)
{
    // Typically, you would provide the tick values to a ProgressBar control.

    if (tickTotal > 0)
    {
        wprintf(L"\n*** Percent complete: %u%%\n", 100*currentTick/tickTotal);
        wprintf(L"*** Currently assessing: %s\n\n", currentState);
    }

    return S_OK;
}

void main(void)
{
    HRESULT hr = S_OK;
    IInitiateWinSATAssessment* pAssessment = NULL;
    CWinSATCallbacks* pCallbacks = NULL;  // Class that implements IWinSATInitiateEvents

    CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);

    // Get an instance of the assessment interface.
    hr = CoCreateInstance(__uuidof(CInitiateWinSAT),
                          NULL,
                          CLSCTX_INPROC_SERVER,
                          __uuidof(IInitiateWinSATAssessment),
                          (void**)&pAssessment);

    if (FAILED(hr))
    {
        wprintf(L"Failed to create an instance of IInitiateWinSATAssessment. Failed with 0x%x.\n", hr);
        goto cleanup;
    }

    wprintf(L"Running formal assessment... hit any key when complete.\n");

    pCallbacks = new CWinSATCallbacks();
    if (NULL == pCallbacks)
    {
        wprintf(L"Failed to create an instance of the CWinSATCallbacks class.\n");
        goto cleanup;
    }

    // Run the formal assessment.
    hr = pAssessment->InitiateFormalAssessment(pCallbacks, NULL);
    if (FAILED(hr))
    {
        // This is a failure to start WinSAT. If WinSAT fails while running, 
        // your implementation of the IWinSATInitiateEvents::WinSATComplete 
        // method will receive the failure code.
        wprintf(L"InitiateFormalAssessment failed with 0x%x.\n", hr);
        goto cleanup;
    }

    while (!_kbhit())
        Sleep(10);

cleanup:

    if (pAssessment)
        pAssessment->Release();

    if (pCallbacks)
        pCallbacks->Release();

    CoUninitialize();
}

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	winsatcominterfacei.h
DLL	Winsatapi.dll

См. также раздел

IInitiateWinSATAssessment

IInitiateWinSATAssessment::InitiateAssessment

IQueryRecentWinSATAssessment

Поделиться через