IDsAdminNotifyHandler::Begin 메서드(dsadmin.h)

아티클
08/23/2023

알림 처리기가 요청한 이벤트가 발생할 때 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