Metodo IDsAdminNotifyHandler::Begin (dsadmin.h)

Il metodo IDsAdminNotifyHandler::Begin viene chiamato quando si verifica un evento richiesto dal gestore di notifica. Il gestore di notifica specifica gli eventi da ricevere notifiche per quando viene chiamato IDAdminNotifyHandler::Initialize .

Sintassi

HRESULT Begin(
  [in]  ULONG       uEvent,
  [in]  IDataObject *pArg1,
  [in]  IDataObject *pArg2,
  [out] ULONG       *puFlags,
  [out] BSTR        *pBstr
);

Parametri

[in] uEvent

Contiene un valore che specifica il tipo di evento che si sta verificando. Questo può essere uno dei valori seguenti.

DSA_NOTIFY_DEL

Un oggetto viene eliminato.

DSA_NOTIFY_REN

Viene rinominato un oggetto.

DSA_NOTIFY_MOV

Un oggetto viene spostato in un altro contenitore.

DSA_NOTIFY_PROP

Viene modificata una o più proprietà di un oggetto.

[in] pArg1

Puntatore a un'interfaccia IDataObject che supporta il formato degli Appunti CFSTR_DSOBJECTNAMES . Il contenuto dell'oggetto dati varia a seconda del valore di uEvent. Per altre informazioni, vedere la sezione Osservazioni.

[in] pArg2

Puntatore a un'interfaccia IDataObject che supporta il formato degli Appunti CFSTR_DSOBJECTNAMES . Il valore di questo parametro e il contenuto dell'oggetto dati varia a seconda del valore di uEvent. Per altre informazioni, vedere la sezione Osservazioni.

[out] puFlags

Puntatore a un valore ULONG che riceve un set di flag che modificano il comportamento del gestore di notifica nella finestra di dialogo di conferma della notifica. Questo può essere zero o una combinazione di uno o più dei valori seguenti.

DSA_NOTIFY_FLAG_ADDITIONAL_DATA

Se questo flag è impostato, la voce per questo gestore di notifica nella finestra di dialogo di conferma viene selezionata. Se questo flag non è impostato, la voce per questo gestore di notifica nella finestra di dialogo di conferma non è selezionata.

DSA_NOTIFY_FLAG_FORCE_ADDITIONAL_DATA

Se questo flag è impostato, la voce per questo gestore di notifica nella finestra di dialogo di conferma è disabilitata e l'utente non può modificare lo stato di selezione.

[out] pBstr

Puntatore a un BSTR che riceve una stringa contenente il nome e/o la descrizione del gestore di notifica. Questa stringa viene visualizzata nella finestra di dialogo di conferma. Questa stringa deve essere allocata chiamando la funzione SysAllocString . Il chiamante deve liberare questa stringa quando non è più necessaria. Se questo parametro riceve NULL o una stringa vuota, il gestore di notifica non viene aggiunto alla finestra di dialogo di conferma e IDsAdminNotifyHandler::Notify non viene chiamato.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK . Se il metodo ha esito negativo, viene restituito un valore HRESULT standard.

Commenti

Il valore e il contenuto di pArg1 e pArg2 variano a seconda dell'evento elaborato come indicato da uEvent. Nell'elenco seguente viene illustrato il valore pArg1 e pArg2 per ogni tipo di evento diverso.

uEvent	pArg1	pArg2
DSA_NOTIFY_DEL	Contiene l'oggetto eliminato.	Non usato. Questo sarà NULL.
DSA_NOTIFY_REN	Contiene il nome precedente dell'oggetto.	Contiene il nuovo nome dell'oggetto.
DSA_NOTIFY_MOV	Contiene il contenitore da cui viene spostato l'oggetto.	Contiene il contenitore a cui viene spostato l'oggetto.
DSA_NOTIFY_PROP	Contiene l'oggetto per cui le proprietà sono state modificate.	Non usato. Questo sarà NULL.

Requisiti

Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsadmin.h
DLL	DSAdmin.dll

Vedi anche

CFSTR_DSOBJECTNAMES

Idataobject

IdAdminNotifyHandler

IDAdminNotifyHandler::Initialize

SysAllocString