Condividi tramite

Metodo IProgressUI::ShowActionProgress

  • Articolo

In Configuration Manager, il ShowActionProgress metodo visualizza informazioni sull'avanzamento delle azioni personalizzate in una finestra di dialogo mentre l'azione personalizzata è in esecuzione.

Sintassi

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

Parametri

pszOrgName

Tipo di dati:BSTR

Qualificatori: [in]

Puntatore al nome dell'organizzazione visualizzato nella finestra di dialogo di stato. Il valore può essere recuperato dalla variabile di _SMSTSOrgName ambiente.

pszTaskSequenceName

Tipo di dati:BSTR

Qualificatori: [in]

Puntatore al nome della sequenza di attività attualmente in esecuzione. Il valore può essere recuperato dalla variabile di _SMSTSPackageName ambiente.

pszCustomTitle

Tipo di dati:BSTR

Qualificatori: [in]

Puntatore al testo per un messaggio personalizzato che sostituisce il testo del titolo predefinito visualizzato nella finestra di dialogo di stato. Passare una stringa vuota se non è presente alcun messaggio personalizzato da visualizzare. Il valore può essere ottenuto dalla variabile di _SMSTSCustomProgressDialogMessage ambiente.

pszCurrentAction

Tipo di dati:BSTR

Qualificatori: [in]

Puntatore al nome del passaggio della sequenza di attività corrente. Il valore può essere ottenuto dalla variabile di _SMSTSCurrentActionName ambiente.

uStep

Tipo di dati:ULONG

Qualificatori: [in]

Numero di passaggio della sequenza di attività corrente. Il valore può essere ottenuto dalla variabile di SMSTSNextInstructionPointer ambiente.

uMaxStep

Tipo di dati:ULONG

Qualificatori: [in]

Numero totale di passaggi nella sequenza di attività. Il valore può essere ottenuto dalla variabile di _SMSTSInstructionTableSize ambiente.

pszActionExecInfo

Tipo di dati:BSTR

Qualificatori: [in]

Puntatore a informazioni sullo stato specifiche dell'azione definite dall'utente da visualizzare nella finestra di dialogo di stato.

uActionExecStep

Tipo di dati:ULONG

Qualificatori: [in]

Il passaggio numerico, all'interno del numero totale di passaggi numerici, su cui l'azione sta attualmente funzionando.

Utilizzare questo parametro per determinare la percentuale dell'azione completata finora. Per altre informazioni, vedere Osservazioni.

uActionExecMaxStep

Tipo di dati:ULONG

Qualificatori: [in]

Numero totale di passaggi numerici eseguiti dall'azione.

Utilizzare questo parametro per determinare la percentuale dell'azione completata finora. Per altre informazioni, vedere Osservazioni.

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.

Osservazioni

Le uniche informazioni necessarie per questo metodo sono per i pszActionExecInfoparametri , uActionExecStepe uActionExecMaxStep . Gli altri parametri possono essere ottenuti dalle variabili di ambiente a cui si fa riferimento.

Una chiamata a ShowActionProgress deve specificare la percentuale di completamento dell'azione usando i uActionExecStep parametri e uActionExecMaxStep . Ad esempio, se uActionExecStep specifica il valore 2 e uActionExecMaxStep specifica il valore 10, la percentuale di completamento dell'azione è del 20%.

Vedere anche