IExtendTaskPad::TaskNotify 메서드(mmc.h)
IExtendTaskPad::TaskNotify 메서드를 사용하면 작업이 확장될 때 MMC가 스냅인을 알릴 수 있습니다. 작업 패드가 목록 보기 작업 패드인 경우 MMC는 목록 보기 단추가 확장 될 때 IExtendTaskPad::TaskNotify 를 호출합니다.
구문
HRESULT TaskNotify(
[in] IDataObject *pdo,
[in] VARIANT *arg,
[in] VARIANT *param
);
매개 변수
[in] pdo
작업 패드를 소유하는 scope 항목의 데이터 개체에 대한 포인터입니다. 스냅인에서 작업 패드를 표시하는 항목을 소유하는 경우 pdo는 해당 항목에 대한 포인터입니다. 스냅인이 다른 스냅인의 작업 패드를 확장하는 경우 pdo는 작업 패드를 소유하는 스냅인의 항목에 대한 포인터입니다.
[in] arg
작업 패드의 CIC 컨트롤에서 다시 전달된 정보를 포함하는 VARIANT 구조체에 대한 포인터입니다.
MMC 작업 패드 템플릿을 사용하는 작업 패드
MMC에서 제공하는 작업 패드의 경우 VARIANT 구조에는 작업 패드 작업에 대한 명령 ID 또는 ed로 표시된 목록 보기 단추가 포함됩니다.
vt 필드는 VT_I4 lVal 필드에는 작업 패드 작업에 대한 명령 ID 또는 ed로 표시된 목록 보기 단추가 포함됩니다. 목록 보기 단추는 목록 보기 작업 패드에만 적용됩니다.
작업 명령 ID는 MMC_TASK 구조의 nCommandID 멤버에 지정됩니다. 이 멤버는 작업 패드를 설치하는 동안 MMC가 해당 작업에 대한 정보를 검색할 때 호출하는 IEnumTASK::Next 메서드에 전달됩니다.
목록 보기 단추는 MMC_LISTPAD_INFO 구조체의 szButtonText 멤버에 지정된 단추로, 목록 보기 작업 패드를 설정할 때 MMC가 호출하는 IExtendTaskPad::GetListPadInfo 메서드에 전달됩니다. 목록 보기 단추 명령 ID는 MMC_LISTPAD_INFO nCommandID 멤버에 지정됩니다.
사용자 지정 HTML 페이지를 사용하는 작업 패드
사용자 지정 작업 패드의 경우 VARIANT 구조에는 사용자 지정 HTML 페이지의 스크립트가 CIC 개체 TaskNotify 메서드를 통과하려는 모든 데이터가 포함될 수 있습니다.
[in] param
작업 패드의 CIC 컨트롤에서 다시 전달된 정보를 포함하는 VARIANT 구조체에 대한 포인터입니다.
MMC 작업 패드 템플릿을 사용하는 작업 패드는 이 매개 변수를 무시합니다. 그러나 사용자 지정 작업 패드는 이를 사용하여 추가 값을 스냅인에 다시 전달할 수 있습니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
설명
스냅인은 pdo 포인터를 사용하여 작업 패드를 소유하는 scope 항목을 식별할 수 있습니다. 그런 다음 arg 매개 변수에 반환된 VARIANT 값으로 작업을 식별할 수 있습니다. 작업 패드가 목록 보기 작업 패드인 경우 스냅인은 IResultData 인터페이스를 사용하여 결과 목록에서 선택한 항목(또는 다중 선택이 지원되는 경우 항목)을 식별할 수 있습니다. 이 데이터를 기반으로 스냅인은 적절한 개체에 대해 적절한 작업을 수행할 수 있습니다.
목록 보기 작업 패드에 대한 작업 패드 목록 보기 단추가 있는 경우 스냅인은 arg 매개 변수에 반환된 VARIANT 값으로 특정 작업 패드의 단추를 식별할 수 있습니다.
사용자 지정 작업 패드는 arg 및 param 매개 변수에 전송되어야 한다고 결정하는 모든 값을 전달할 수 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | mmc.h |