Dela via


IProgressUI::ShowActionProgress-metod

I Configuration Manager ShowActionProgress visar metoden information om anpassade åtgärdsförlopp i en dialogruta medan den anpassade åtgärden körs.

Syntax

[IDL]
HRESULT ShowActionProgress(
     BSTR pszOrgName,
     BSTR pszTaskSequenceName,
     BSTR pszCustomTitle,
     BSTR pszCurrentAction,
     ULONG uStep,
     ULONG uMaxStep,
     BSTR pszActionExecInfo,
     ULONG uActionExecStep,
     ULONG uActionExecMaxStep
);

Parametrar

pszOrgName

Datatyp: BSTR

Kvalificerare: [in]

Pekare till organisationsnamnet som visas i dialogrutan för förlopp. Värdet kan hämtas från _SMSTSOrgName miljövariabeln.

pszTaskSequenceName

Datatyp: BSTR

Kvalificerare: [in]

Pekare mot namnet på den aktivitetssekvens som körs för närvarande. Värdet kan hämtas från _SMSTSPackageName miljövariabeln.

pszCustomTitle

Datatyp: BSTR

Kvalificerare: [in]

Pekare till texten för ett anpassat meddelande som ersätter standardrubriktexten som visas i dialogrutan för förlopp. Skicka en tom sträng om det inte finns något anpassat meddelande att visa. Värdet kan hämtas från _SMSTSCustomProgressDialogMessage miljövariabeln.

pszCurrentAction

Datatyp: BSTR

Kvalificerare: [in]

Pekare mot namnet på det aktuella aktivitetssekvenssteget. Värdet kan hämtas från _SMSTSCurrentActionName miljövariabeln.

uStep

Datatyp: ULONG

Kvalificerare: [in]

Aktuellt aktivitetssekvensstegnummer. Värdet kan hämtas från SMSTSNextInstructionPointer miljövariabeln.

uMaxStep

Datatyp: ULONG

Kvalificerare: [in]

Det totala antalet steg i aktivitetssekvensen. Värdet kan hämtas från _SMSTSInstructionTableSize miljövariabeln.

pszActionExecInfo

Datatyp: BSTR

Kvalificerare: [in]

Pekar på användardefinierad, åtgärdsspecifik förloppsinformation som ska visas i dialogrutan för förlopp.

uActionExecStep

Datatyp: ULONG

Kvalificerare: [in]

Det numeriska steget, inom det totala antalet numeriska steg, där åtgärden för närvarande fungerar.

Använd den här parametern för att fastställa procentandelen av åtgärden som har slutförts hittills. Mer information finns i Anmärkningar.

uActionExecMaxStep

Datatyp: ULONG

Kvalificerare: [in]

Det totala antalet numeriska steg som åtgärden gör.

Använd den här parametern för att fastställa procentandelen av åtgärden som har slutförts hittills. Mer information finns i Anmärkningar.

Returnera värden

En HRESULT kod. Möjliga värden inkluderar, men är inte begränsade till, följande värde. HRESULT Inga värden returneras som är specifika för den här metoden.

S_OK Metoden lyckades.

Anmärkningar

Den enda nödvändiga informationen för den här metoden är för parametrarna pszActionExecInfo, uActionExecStepoch uActionExecMaxStep . De andra parametrarna kan hämtas från de refererade miljövariablerna.

Ett anrop till ShowActionProgress ska ange den procentuella slutförandet av åtgärden med hjälp av parametrarna uActionExecStep och uActionExecMaxStep . Om uActionExecStep till exempel anger värdet 2 och uActionExecMaxStep anger värdet 10 är åtgärdens procentuella slutförande 20 procent.

Se även