IDsAdminNotifyHandler::Begin 메서드(dsadmin.h)
알림 처리기가 요청한 이벤트가 발생할 때 IDsAdminNotifyHandler::Begin 메서드가 호출됩니다. 알림 처리기는 IDsAdminNotifyHandler::Initialize 가 호출될 때 알림을 받을 이벤트를 지정합니다.
구문
HRESULT Begin(
[in] ULONG uEvent,
[in] IDataObject *pArg1,
[in] IDataObject *pArg2,
[out] ULONG *puFlags,
[out] BSTR *pBstr
);
매개 변수
[in] uEvent
발생 하는 이벤트의 형식을 지정 하는 값을 포함 합니다. 다음 값 중 하나일 수 있습니다.
DSA_NOTIFY_DEL
개체가 삭제됩니다.
DSA_NOTIFY_REN
개체의 이름이 바뀝니다.
DSA_NOTIFY_MOV
개체가 다른 컨테이너로 이동됩니다.
DSA_NOTIFY_PROP
개체의 속성이 하나 이상 수정됩니다.
[in] pArg1
CFSTR_DSOBJECTNAMES 클립보드 형식을 지원하는 IDataObject 인터페이스에 대한 포인터입니다. 데이터 개체의 내용은 uEvent 값에 따라 달라집니다. 자세한 내용은 주의 섹션을 참조하세요.
[in] pArg2
CFSTR_DSOBJECTNAMES 클립보드 형식을 지원하는 IDataObject 인터페이스에 대한 포인터입니다. 이 매개 변수의 값과 데이터 개체의 내용은 uEvent 값에 따라 달라집니다. 자세한 내용은 주의 섹션을 참조하세요.
[out] puFlags
알림 확인 대화 상자에서 알림 처리기의 동작을 수정하는 플래그 집합을 수신하는 ULONG 값에 대한 포인터입니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.
DSA_NOTIFY_FLAG_ADDITIONAL_DATA
이 플래그를 설정하면 확인 대화 상자에서 이 알림 처리기의 항목이 선택됩니다. 이 플래그를 설정하지 않으면 확인 대화 상자에서 이 알림 처리기의 항목이 선택되지 않습니다.
DSA_NOTIFY_FLAG_FORCE_ADDITIONAL_DATA
이 플래그를 설정하면 확인 대화 상자에서 이 알림 처리기의 항목이 비활성화되고 사용자가 선택 상태를 변경할 수 없습니다.
[out] pBstr
알림 처리기의 이름 및/또는 설명이 포함된 문자열을 수신하는 BSTR 에 대한 포인터입니다. 이 문자열은 확인 대화 상자에 표시됩니다. 이 문자열은 SysAllocString 함수를 호출하여 할당해야 합니다. 호출자는 더 이상 필요하지 않은 경우 이 문자열을 해제해야 합니다. 이 매개 변수가 NULL 또는 빈 문자열을 받으면 알림 처리기가 확인 대화 상자에 추가되지 않고 IDsAdminNotifyHandler::Notify 가 호출되지 않습니다.
반환 값
메서드가 성공하면 S_OK 반환됩니다. 메서드가 실패하면 표준 HRESULT 값이 반환됩니다.
설명
pArg1 및 pArg2의 값과 콘텐츠는 uEvent에서 나타내는 대로 처리되는 이벤트에 따라 달라집니다. 다음 목록에서는 각기 다른 이벤트 유형에 대해 pArg1 및 pArg2 에 포함할 내용에 대해 설명합니다.
| uEvent | pArg1 | pArg2 |
|---|---|---|
| DSA_NOTIFY_DEL | 삭제된 개체를 포함합니다. | 사용되지 않습니다. NULL이 됩니다. |
| DSA_NOTIFY_REN | 개체의 이전 이름을 포함합니다. | 개체의 새 이름을 포함합니다. |
| DSA_NOTIFY_MOV | 개체가 이동되는 컨테이너를 포함합니다. | 개체가 이동되는 컨테이너를 포함합니다. |
| DSA_NOTIFY_PROP | 속성이 변경된 개체를 포함합니다. | 사용되지 않습니다. NULL이 됩니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | dsadmin.h |
| DLL | DSAdmin.dll |