IProgressUI ::ShowErrorDialog méthode

Dans le Configuration Manager, la méthode affiche des informations d’erreur ShowErrorDialog personnalisables dans une boîte de dialogue.

Syntaxe

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

Paramètres

pszOrgName

Type de donnéesBSTR

Qualificatifs : [dans]

Pointeur sur le nom de l’organisation qui s’affiche dans la boîte de dialogue de progression. La valeur peut être récupérée à partir de la variable d’environnement _SMSTSOrgName .

pszTaskSequenceName

Type de donnéesBSTR

Qualificatifs : [dans]

Pointeur sur le nom de la séquence de tâches en cours d’exécution. La valeur peut être récupérée à partir de la variable d’environnement _SMSTSPackageName .

pszCustomTitle

Type de donnéesBSTR

Qualificatifs : [dans]

Pointeur sur le texte d’un message personnalisé qui remplace le texte du titre par défaut affiché dans la boîte de dialogue d’erreur. Transmettez une chaîne vide s’il n’y a aucun message personnalisé à afficher. La valeur peut être obtenue à partir de la variable d’environnement _SMSTSCustomProgressDialogMessage .

pszErrorMessage

Type de donnéesBSTR

Qualificatifs : [dans]

Pointeur sur le texte du message personnalisé qui s’affiche dans la boîte de dialogue d’erreur. Transmettez une chaîne vide s’il n’y a aucun message personnalisé à afficher. Le texte par défaut inclut le texte de pszTaskSequenceName, pszTaskSequenceStepName, et uErrorCode. Elle varie en fonction des valeurs spécifiées.

uErrorCode

Type de donnéesULONG

Qualificatifs : [dans]

Pointeur sur le code de retour de la dernière étape qui a échoué. La valeur peut être obtenue à partir de la variable d’environnement _SMSTSLastActionRetCode . Si aucun texte pszErrorMessage personnalisé n’est spécifié, uErrorCode il s’affiche au format de code d’erreur système Microsoft .

uTimeoutInSeconds

Type de donnéesULONG

Qualificatifs : [dans]

Pointeur sur la valeur du nombre de secondes pendant lesquelles la boîte de dialogue s’affiche avant de se fermer. La valeur peut être obtenue à partir de la SMSTSErrorDialogTimeout variable d’environnement, qui n’est pas configurée par défaut dans la séquence de tâches. Si une chaîne vide est spécifiée pour uTimeoutInSeconds et SMSTSErrorDialogTimeout n’est pas spécifiée, une valeur par défaut de 900 secondes est utilisée.

bWillReboot

Type de donnéesULONG

Qualificatifs : [dans]

Valeur booléenne Il indique si la séquence de tâches redémarrera l’ordinateur à la fermeture de la boîte de dialogue ou à l’expiration du délai d’expiration.

pszTaskSequenceStepName

Type de donnéesBSTR

Qualificatifs : [dans]

Pointeur sur le nom du nom de l’étape qui sera affiché dans le texte par défaut pszErrorMessage . La valeur peut être récupérée à partir de la variable d’environnement _SMSTSLastActionName .

Valeurs de retour

Un HRESULT code. Les valeurs possibles incluent, sans toutefois s’y limiter, la valeur suivante. Aucune valeur spécifique à cette méthode n’est HRESULT renvoyée.

S_OK La méthode a réussi.

Voir aussi

  • Last updated on