Metoda IProgressUI::ShowActionProgress

W programie Configuration Manager metoda ShowActionProgress wyświetla informacje o postępie akcji niestandardowej w oknie dialogowym, gdy akcja niestandardowa jest uruchomiona.

Składnia

[IDL]
HRESULT ShowActionProgress(
     BSTR pszOrgName,
     BSTR pszTaskSequenceName,
     BSTR pszCustomTitle,
     BSTR pszCurrentAction,
     ULONG uStep,
     ULONG uMaxStep,
     BSTR pszActionExecInfo,
     ULONG uActionExecStep,
     ULONG uActionExecMaxStep
);

Parametry

pszOrgName

Typ danych: BSTR

Kwalifikatory: [in]

Wskaźnik do nazwy organizacji wyświetlanej w oknie dialogowym postępu. Wartość można pobrać ze _SMSTSOrgName zmiennej środowiskowej.

pszTaskSequenceName

Typ danych: BSTR

Kwalifikatory: [in]

Wskaźnik do nazwy aktualnie uruchomionej sekwencji zadań. Wartość można pobrać ze _SMSTSPackageName zmiennej środowiskowej.

pszCustomTitle

Typ danych: BSTR

Kwalifikatory: [in]

Wskaźnik do tekstu wiadomości niestandardowej, który zastępuje domyślny tekst tytułu wyświetlany w oknie dialogowym postępu. Przekaż pusty ciąg, jeśli nie ma komunikatu niestandardowego do wyświetlenia. Wartość można uzyskać ze zmiennej _SMSTSCustomProgressDialogMessage środowiskowej.

pszCurrentAction

Typ danych: BSTR

Kwalifikatory: [in]

Wskaźnik do nazwy bieżącego kroku sekwencji zadań. Wartość można uzyskać ze zmiennej _SMSTSCurrentActionName środowiskowej.

uStep

Typ danych: ULONG

Kwalifikatory: [in]

Numer bieżącego etapu sekwencji zadania. Wartość można uzyskać ze zmiennej SMSTSNextInstructionPointer środowiskowej.

uMaxStep

Typ danych: ULONG

Kwalifikatory: [in]

Całkowita liczba kroków w sekwencji zadań. Wartość można uzyskać ze zmiennej _SMSTSInstructionTableSize środowiskowej.

pszActionExecInfo

Typ danych: BSTR

Kwalifikatory: [in]

Wskaźnik do zdefiniowanych przez użytkownika informacji o postępie specyficznych dla akcji, które mają być wyświetlane w oknie dialogowym postępu.

uActionExecStep

Typ danych: ULONG

Kwalifikatory: [in]

Krok numeryczny w ramach całkowitej liczby kroków numerycznych, w ramach których akcja jest obecnie wykonywana.

Ten parametr służy do określania procentowego udziału akcji, który został wykonany do tej pory. Aby uzyskać więcej informacji, zobacz Spostrzeżenia.

uActionExecMaxStep

Typ danych: ULONG

Kwalifikatory: [in]

Całkowita liczba liczbowych kroków wykonywanych przez akcję.

Ten parametr służy do określania procentowego udziału akcji, który został wykonany do tej pory. Aby uzyskać więcej informacji, zobacz Spostrzeżenia.

Wartości zwracane

Kod HRESULT . Możliwe wartości to między innymi następujące wartości, ale nie są do nich ograniczone. Nie są zwracane żadne HRESULT wartości specyficzne dla tej metody.

S_OK Metoda zakończyła się powodzeniem.

Uwagi

Jedynymi informacjami wymaganymi dla tej metody są pszActionExecInfoparametry , uActionExecStep, i uActionExecMaxStep . Pozostałe parametry można uzyskać z przywoływanych zmiennych środowiskowych.

Wywołanie ShowActionProgress powinno określać procent ukończenia akcji przy użyciu uActionExecStepuActionExecMaxStep and parametrów. Na przykład jeśli uActionExecStep określa wartość 2 oraz uActionExecMaxStep wartość 10, procent wykonania akcji wynosi 20 procent.

Zobacz też

  • Last updated on