Udostępnij za pośrednictwem

IProgressUI::ShowErrorDialog — Metoda

  • Artykuł

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

Składni

[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: [w]

Wskaźnik do nazwy organizacji, która jest wyświetlana w oknie dialogowym postępu. Wartość można pobrać ze zmiennej środowiskowej _SMSTSOrgName .

pszTaskSequenceName

Typ danych: BSTR

Kwalifikatory: [w]

Wskaźnik do nazwy sekwencji zadań, która jest obecnie uruchomiona. Wartość można pobrać ze zmiennej środowiskowej _SMSTSPackageName .

pszCustomTitle

Typ danych: BSTR

Kwalifikatory: [w]

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 niestandardowego komunikatu do wyświetlenia. Wartość można uzyskać ze zmiennej środowiskowej _SMSTSCustomProgressDialogMessage .

pszErrorMessage

Typ danych: BSTR

Kwalifikatory: [w]

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

uErrorCode

Typ danych: ULONG

Kwalifikatory: [w]

Wskaźnik do kodu powrotnego ostatniego kroku, który nie powiódł się. Wartość można uzyskać ze zmiennej środowiskowej _SMSTSLastActionRetCode . Jeśli nie określono tekstu niestandardowego, pszErrorMessage zostanie wyświetlony uErrorCodew formacie kodu błędu systemu Microsoft.

uTimeoutInSeconds

Typ danych: ULONG

Kwalifikatory: [w]

Wskaźnik do wartości liczby sekund wyświetlanych w oknie dialogowym przed zamknięciem. Wartość można uzyskać ze zmiennej środowiskowej SMSTSErrorDialogTimeout , która nie jest domyślnie skonfigurowana w sekwencji zadań. Jeśli dla uTimeoutInSeconds parametru i SMSTSErrorDialogTimeout nie określono pustego ciągu, zostanie użyte ustawienie domyślne 900 sekund.

bWillReboot

Typ danych: ULONG

Kwalifikatory: [w]

Wartość logiczna. Wskazuje, czy sekwencja zadań uruchomi ponownie komputer po zamknięciu okna dialogowego lub wygaśnie limit czasu.

pszTaskSequenceStepName

Typ danych: BSTR

Kwalifikatory: [w]

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

Zwracane wartości

Kod HRESULT . Możliwe wartości obejmują, ale nie są ograniczone do następującej wartości. Nie są zwracane żadne HRESULT wartości specyficzne dla tej metody.

S_OK
Metoda zakończyła się pomyślnie.

Zobacz też