Megosztás a következőn keresztül:

IProgressUI::ShowMessageEx metódus

  • Cikk

A 2006-os verziótól kezdődően a ShowMessageEx metódus egy testre szabható párbeszédpanelt jelenít meg. Ez a metódus hasonló az IProgressUI::ShowMessage metódushoz, de tartalmaz egy új, pResult nevű egész szám eredményváltozót is.

Szintaxis

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

Paraméterek

pszText

Adattípus: BSTR

Minősítők: [in]

Az üzenetpanel törzsében megjelenő szöveg.

pszCaption

Adattípus: BSTR

Minősítők: [in]

Az üzenetpanel ablakfejlécében megjelenő szöveg.

uType

Adattípus: ULONG

Minősítők: [in]

A gombok alábbi lehetséges értékeinek megfelelő érték:

  • 0 – Ok
  • 1 – Ok/Mégse
  • 2 – Megszakítás/Újrapróbálkzás/Figyelmen kívül hagyás
  • 3 – Igen/Nem/Mégse
  • 4 – Igen/Nem
  • 5 – Újrapróbálkozás/Megszakítás
  • 6 – Megszakítás/Újrapróbálkozás/Folytatás

pResult

Adattípus: INT

Minősítők: [ki]

Ennek a változónak az értéke egy szabványos Windows-üzenetpanel visszatérési értéke.

Értékek visszaadott értéke

Egy HRESULT kód. A lehetséges értékek közé tartozik, de nem kizárólagosan a következő érték. HRESULT Nincsenek visszaadott értékek, amelyek erre a metódusra vonatkoznak.

S_OK
A metódus sikeres volt.

A felhasználó üzenetmezőre adott válaszának kiértékeléséhez használja a pResult paramétert .

Példa

A következő PowerShell-példaszkript bemutatja, hogyan használhatja ezt a módszert:

$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'
}

Ehhez hasonló szkriptet a feladatütemezés PowerShell-szkript futtatása lépésében használhat. Ha a felhasználó az Igen lehetőséget választja az egyéni ablakban, a szkript létrehoz egy TS-UserPressedButton nevű egyéni feladatütemezési változót, amelynek Yesértéke . Ezt a feladatütemezési változót ezután más szkriptekben vagy más feladatütemezési lépések feltételeként is használhatja.

Lásd még