Metodo IProgressUI::ShowActionProgress

In Configuration Manager, il metodo visualizza informazioni sullo stato di avanzamento dell'azione ShowActionProgress personalizzata in una finestra di dialogo durante l'esecuzione dell'azione personalizzata.

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

Qualificazioni: [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

Qualificazioni: [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

Qualificazioni: [in]

Puntatore al testo di un messaggio personalizzato che sostituisce il testo del titolo predefinito visualizzato nella finestra di dialogo di avanzamento. 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

Qualificazioni: [in]

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

uStep

Tipo di dati:ULONG

Qualificazioni: [in]

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

uMaxStep

Tipo di dati:ULONG

Qualificazioni: [in]

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

pszActionExecInfo

Tipo di dati:BSTR

Qualificazioni: [in]

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

uActionExecStep

Tipo di dati:ULONG

Qualificazioni: [in]

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

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

uActionExecMaxStep

Tipo di dati:ULONG

Qualificazioni: [in]

Numero totale di passaggi numerici eseguiti dall'azione.

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

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.

Osservazioni

Le uniche informazioni necessarie per questo metodo sono per i pszActionExecInfoparametri , uActionExecStep, e 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 utilizzando i uActionExecStep parametri and uActionExecMaxStep . Ad esempio, se uActionExecStep si specifica il valore 2 e uActionExecMaxStep il valore 10, la percentuale di completamento dell'azione è pari al 20%.

Vedere anche

  • Last updated on