Metodo IProgressUI::ShowMessageEx

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 intero, pResult.

Sintassi

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

Parametri

pszText

Tipo di dati:BSTR

Qualificazioni: [in]

Testo visualizzato nel corpo del messaggio

pszCaption

Tipo di dati:BSTR

Qualificazioni: [in]

Testo visualizzato nell'intestazione della finestra di messaggio.

uType

Tipo di dati:ULONG

Qualificazioni: [in]

Il valore corrispondente a uno dei seguenti valori possibili per i pulsanti:

  • 0 - OK
  • 1 - OK/Annulla
  • 2 - Interrompi/Riprova/Ignora
  • 3 - Sì/No/Annulla
  • 4 - Sì/No
  • 5 - Riprova/annulla
  • 6 - Annulla/Riprova/Continua

pResult

Tipo di dati:INT

Qualificazioni: [fuori]

Il valore di questa variabile è un valore restituito standard di Windows Message Box.

Valori restituiti

Un HRESULT codice. I valori possibili includono, ma non sono limitati a, il valore seguente. Non HRESULT sono restituiti valori specifici per questo metodo.

S_OK Il metodo ha avuto esito positivo.

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

Esempio

L'esempio di script di PowerShell seguente mostra 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 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 un valore di Yes. È quindi possibile usare questa variabile della sequenza di attività in altri script o come condizione per altri passaggi della sequenza di attività.

Vedere anche

  • Last updated on