IProgressUI::ShowActionProgress 메서드

  • 아티클

Configuration Manager 메서드는 ShowActionProgress 사용자 지정 작업이 실행되는 동안 대화 상자에 사용자 지정 작업 진행률 정보를 표시합니다.

구문

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

매개 변수

pszOrgName

데이터 형식: BSTR

한정자: [in]

진행률 대화 상자에 표시되는 조직 이름에 대한 포인터입니다. 환경 변수에서 _SMSTSOrgName 값을 검색할 수 있습니다.

pszTaskSequenceName

데이터 형식: BSTR

한정자: [in]

현재 실행 중인 작업 순서의 이름에 대한 포인터입니다. 환경 변수에서 _SMSTSPackageName 값을 검색할 수 있습니다.

pszCustomTitle

데이터 형식: BSTR

한정자: [in]

진행률 대화 상자에 표시되는 기본 제목 텍스트를 대체하는 사용자 지정 메시지의 텍스트에 대한 포인터입니다. 표시할 사용자 지정 메시지가 없는 경우 빈 문자열을 전달합니다. 환경 변수에서 _SMSTSCustomProgressDialogMessage 값을 가져올 수 있습니다.

pszCurrentAction

데이터 형식: BSTR

한정자: [in]

현재 작업 순서 단계의 이름에 대한 포인터입니다. 환경 변수에서 _SMSTSCurrentActionName 값을 가져올 수 있습니다.

uStep

데이터 형식: ULONG

한정자: [in]

현재 작업 순서 단계 번호입니다. 환경 변수에서 SMSTSNextInstructionPointer 값을 가져올 수 있습니다.

uMaxStep

데이터 형식: ULONG

한정자: [in]

작업 순서의 총 단계 수입니다. 환경 변수에서 _SMSTSInstructionTableSize 값을 가져올 수 있습니다.

pszActionExecInfo

데이터 형식: BSTR

한정자: [in]

진행률 대화 상자에 표시할 사용자 정의 작업별 진행률 정보에 대한 포인터입니다.

uActionExecStep

데이터 형식: ULONG

한정자: [in]

현재 동작이 작동 중인 숫자 단계의 총 수 내에 있는 숫자 단계입니다.

이 매개 변수를 사용하여 지금까지 완료된 작업의 백분율을 확인합니다. 자세한 내용은 참고를 참조하십시오.

uActionExecMaxStep

데이터 형식: ULONG

한정자: [in]

작업이 수행하는 총 숫자 단계 수입니다.

이 매개 변수를 사용하여 지금까지 완료된 작업의 백분율을 확인합니다. 자세한 내용은 참고를 참조하십시오.

반환값

코드입니다 HRESULT . 가능한 값에는 다음 값이 포함되지만 이에 국한되지는 않습니다. 이 메서드와 관련된 값이 반환되지 않습니다 HRESULT .

S_ok
메서드가 성공했습니다.

설명

이 메서드에 필요한 유일한 정보는 , uActionExecStep및 uActionExecMaxStep 매개 변수에 대한 pszActionExecInfo것입니다. 다른 매개 변수는 참조된 환경 변수에서 가져올 수 있습니다.

에 대한 ShowActionProgress 호출은 및 uActionExecMaxStep 매개 변수를 사용하여 uActionExecStep 작업의 완료율을 지정해야 합니다. 예를 들어 값 2를 지정하고 uActionExecMaxStep 값 10을 지정하는 경우 uActionExecStep 작업의 완료율은 20%입니다.

참고 항목