Condividi tramite

Metodo IProgressUI::ShowMessageEx

  • Articolo

A partire dalla versione 2006, il ShowMessageEx metodo visualizza una finestra di dialogo personalizzabile. Questo metodo è simile al metodo IProgressUI::ShowMessage , ma include anche una nuova variabile di risultato integer, pResult.

Sintassi

[IDL]  
HRESULT ShowMessageEx(  
     BSTR pszText,  
     BSTR pszCaption,  
     ULONG uType,
     INT *pResult
);

Parametri

pszText

Tipo di dati:BSTR

Qualificatori: [in]

Testo visualizzato nel corpo della finestra di messaggio.

pszCaption

Tipo di dati:BSTR

Qualificatori: [in]

Testo visualizzato nell'intestazione delle finestre della finestra della finestra di messaggio.

uType

Tipo di dati:ULONG

Qualificatori: [in]

Valore corrispondente a uno dei valori possibili seguenti per i pulsanti:

  • 0 - Ok
  • 1 - Ok/Annulla
  • 2 - Abort/Retry/Ignore
  • 3 - Sì/No/Annulla
  • 4 - Sì/No
  • 5 - Riprovare/Annullare
  • 6 - Annulla/Riprova/Continua

pResult

Tipo di dati:INT

Qualificatori: [out]

Il valore di questa variabile è un valore restituito della finestra di messaggio standard di Windows.

Valori restituiti

Codice HRESULT . I valori possibili includono, ma non si limitano a, il valore seguente. Non sono HRESULT stati restituiti valori specifici di questo metodo.

S_OK
Il metodo ha avuto esito positivo.

Per valutare la risposta dell'utente alla finestra di messaggio, usare il parametro pResult .

Esempio

L'esempio di script di PowerShell seguente illustra come usare questo metodo:

$Message = "Can you see this message?"
$Title = "Contoso IT"
$Type = 4 # Yes/No
$Output = 0

$TaskSequenceProgressUi = New-Object -ComObject "Microsoft.SMS.TSProgressUI"
$TaskSequenceProgressUi.ShowMessageEx($Message, $Title, $Type, [ref]$Output)

$TSEnv = New-Object -ComObject "Microsoft.SMS.TSEnvironment"
if ($Output -eq 6) {
$TSEnv.Value("TS-UserPressedButton") = 'Yes'
}

È possibile usare uno script come questo nel passaggio Esegui script di PowerShell nella sequenza di attività. Se l'utente seleziona Sì nella finestra personalizzata, lo script crea una variabile della sequenza di attività personalizzata TS-UserPressedButton con il valore Yes. È quindi possibile usare questa variabile della sequenza di attività in altri script o come condizione in altri passaggi della sequenza di attività.

Vedere anche