IProgressUI::ShowActionProgress-methode

In Configuration Manager geeft de ShowActionProgress methode aangepaste informatie over de voortgang van acties weer in een dialoogvenster terwijl de aangepaste actie wordt uitgevoerd.

Syntaxis

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

Parameters

pszOrgName

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de naam van de organisatie die wordt weergegeven in het voortgangsdialoogvenster. De waarde kan worden opgehaald uit de _SMSTSOrgName omgevingsvariabele.

pszTaskSequenceName

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de naam van de takenreeks die momenteel wordt uitgevoerd. De waarde kan worden opgehaald uit de _SMSTSPackageName omgevingsvariabele.

pszCustomTitle

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de tekst voor een aangepast bericht ter vervanging van de standaardtiteltekst in het voortgangsdialoogvenster. Geef een lege tekenreeks door als er geen aangepast bericht is om weer te geven. De waarde kan worden opgehaald uit de _SMSTSCustomProgressDialogMessage omgevingsvariabele.

pszCurrentAction

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de naam van de huidige stap in de takenreeks. De waarde kan worden opgehaald uit de _SMSTSCurrentActionName omgevingsvariabele.

uStep

Gegevenstype: ULONG

Kwalificaties: [in]

Het huidige stapnummer van de taakreeks. De waarde kan worden opgehaald uit de SMSTSNextInstructionPointer omgevingsvariabele.

uMaxStep

Gegevenstype: ULONG

Kwalificaties: [in]

Het totale aantal stappen in de takenreeks. De waarde kan worden opgehaald uit de _SMSTSInstructionTableSize omgevingsvariabele.

pszActionExecInfo

Gegevenstype: BSTR

Kwalificaties: [in]

Verwijzing naar door de gebruiker gedefinieerde, actiespecifieke voortgangsgegevens die in het voortgangsdialoogvenster.

uActionExecStep

Gegevenstype: ULONG

Kwalificaties: [in]

De numerieke stap binnen het totale aantal numerieke stappen waaraan de actie momenteel wordt uitgevoerd.

Gebruik deze parameter om het percentage van de actie te bepalen dat tot dusver is voltooid. Voor meer informatie, zie Opmerkingen.

uActionExecMaxStep

Gegevenstype: ULONG

Kwalificaties: [in]

Het totale aantal numerieke stappen dat door de actie wordt uitgevoerd.

Gebruik deze parameter om het percentage van de actie te bepalen dat tot dusver is voltooid. Voor meer informatie, zie Opmerkingen.

Retourwaarden

Een HRESULT code. Mogelijke waarden zijn onder meer: de volgende waarde. Er worden geen HRESULT waarden geretourneerd die specifiek zijn voor deze methode.

S_OK De methode is geslaagd.

Opmerkingen

De enige vereiste gegevens voor deze methode zijn de pszActionExecInfo, uActionExecStep, en uActionExecMaxStep parameters. De andere parameters kunnen worden afgeleid uit de omgevingsvariabelen waarnaar wordt verwezen.

Een aanroep om ShowActionProgress moet het voltooiingspercentage van de actie specificeren met behulp van de uActionExecStep and-parameters uActionExecMaxStep . Als uActionExecStep u bijvoorbeeld de waarde 2 opgeeft en uActionExecMaxStep de waarde 10, is het voltooiingspercentage van de actie 20%.

Zie ook

  • Last updated on