Metoda IProgressUI::ShowErrorDialog

W programie Configuration Manager metoda ShowErrorDialog ta wyświetla w oknie dialogowym dostosowywalne informacje o błędach.

Składnia

[IDL]
HRESULT ShowErrorDialog(
     BSTR pszOrgName,
     BSTR pszTaskSequenceName,
     BSTR pszCustomTitle,
     BSTR pszErrorMessage,
     ULONG uErrorCode,
     ULONG uTimeoutInSeconds,
     ULONG uWillReboot,
     BSTR pszTaskSequenceStepName
);

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 komunikatu niestandardowego, który zastępuje domyślny tekst tytułu wyświetlany w oknie dialogowym błędu. Przekaż pusty ciąg, jeśli nie ma komunikatu niestandardowego do wyświetlenia. Wartość można uzyskać ze zmiennej _SMSTSCustomProgressDialogMessage środowiskowej.

pszErrorMessage

Typ danych: BSTR

Kwalifikatory: [in]

Wskaźnik do tekstu komunikatu niestandardowego wyświetlanego w oknie dialogowym błędu. Przekaż pusty ciąg, jeśli nie ma komunikatu niestandardowego do wyświetlenia. Domyślny tekst zawiera teksty z pszTaskSequenceName, pszTaskSequenceStepName, i uErrorCode. Zmienia się w zależności od tego, które wartości są określone.

uErrorCode

Typ danych: ULONG

Kwalifikatory: [in]

Wskaźnik do kodu powrotnego ostatniego kroku, który zakończył się niepowodzeniem. Wartość można uzyskać ze zmiennej _SMSTSLastActionRetCode środowiskowej. Jeśli nie zostanie określony tekst niestandardowy pszErrorMessage , uErrorCode będzie wyświetlany w formacie kodów błędów systemu Microsoft .

uTimeoutInSeconds

Typ danych: ULONG

Kwalifikatory: [in]

Wskaźnik do wartości określającej liczbę sekund, przez które okno dialogowe jest wyświetlane przed zamknięciem. Wartość można uzyskać ze zmiennej SMSTSErrorDialogTimeout środowiskowej, która nie jest domyślnie skonfigurowana w sekwencji zadań. Jeśli zostanie określony pusty ciąg i uTimeoutInSecondsSMSTSErrorDialogTimeout nie zostanie określony, zostanie użyta wartość domyślna 900 sekund.

bWillReboot

Typ danych: ULONG

Kwalifikatory: [in]

Wartość logiczna. Wskazuje, czy sekwencja zadań spowoduje ponowne uruchomienie komputera po zamknięciu okna dialogowego lub po wygaśnięciu limitu czasu.

pszTaskSequenceStepName

Typ danych: BSTR

Kwalifikatory: [in]

Wskaźnik do tekstu nazwy etapu, który będzie wyświetlany w tekście domyślnym pszErrorMessage . Wartość można pobrać ze _SMSTSLastActionName zmiennej środowiskowej.

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.

Zobacz też

  • Last updated on