Método IDsAdminNotifyHandler::Begin (dsadmin.h)
Se llama al método IDsAdminNotifyHandler::Begin cuando se produce un evento que el controlador de notificaciones ha solicitado. El controlador de notificaciones especifica los eventos para los que se van a recibir notificaciones cuando se llama a IDsAdminNotifyHandler::Initialize .
Sintaxis
HRESULT Begin(
[in] ULONG uEvent,
[in] IDataObject *pArg1,
[in] IDataObject *pArg2,
[out] ULONG *puFlags,
[out] BSTR *pBstr
);
Parámetros
[in] uEvent
Contiene un valor que especifica el tipo de evento que se está produciendo. Puede ser uno de los siguientes valores.
DSA_NOTIFY_DEL
Se elimina un objeto .
DSA_NOTIFY_REN
Se cambia el nombre de un objeto.
DSA_NOTIFY_MOV
Un objeto se mueve a otro contenedor.
DSA_NOTIFY_PROP
Se modifican una o varias propiedades de un objeto.
[in] pArg1
Puntero a una interfaz IDataObject que admite el formato del Portapapeles de CFSTR_DSOBJECTNAMES . El contenido del objeto de datos variará en función del valor de uEvent. Para obtener más información, vea la sección Comentarios.
[in] pArg2
Puntero a una interfaz IDataObject que admite el formato del Portapapeles de CFSTR_DSOBJECTNAMES . El valor de este parámetro y el contenido del objeto de datos variará en función del valor de uEvent. Para obtener más información, vea la sección Comentarios.
[out] puFlags
Puntero a un valor de ULONG que recibe un conjunto de marcas que modifican el comportamiento del controlador de notificaciones en el cuadro de diálogo de confirmación de notificación. Puede ser cero o una combinación de uno o varios de los valores siguientes.
DSA_NOTIFY_FLAG_ADDITIONAL_DATA
Si se establece esta marca, se selecciona la entrada de este controlador de notificaciones en el cuadro de diálogo de confirmación. Si no se establece esta marca, no se selecciona la entrada de este controlador de notificaciones en el cuadro de diálogo de confirmación.
DSA_NOTIFY_FLAG_FORCE_ADDITIONAL_DATA
Si se establece esta marca, la entrada de este controlador de notificaciones en el cuadro de diálogo de confirmación está deshabilitada y el usuario no puede cambiar el estado de selección.
[out] pBstr
Puntero a un BSTR que recibe una cadena que contiene el nombre o la descripción del controlador de notificaciones. Esta cadena se muestra en el cuadro de diálogo de confirmación. Esta cadena debe asignarse llamando a la función SysAllocString . El autor de la llamada debe liberar esta cadena cuando ya no sea necesaria. Si este parámetro recibe NULL o una cadena vacía, no se agrega el controlador de notificaciones al cuadro de diálogo de confirmación y no se llama a IDsAdminNotifyHandler::Notify .
Valor devuelto
Si el método se realiza correctamente, se devuelve S_OK . Si se produce un error en el método, se devuelve un valor HRESULT estándar.
Comentarios
El valor y el contenido de pArg1 y pArg2 varían en función del evento procesado según lo indicado por uEvent. En la lista siguiente se explica qué contendrá pArg1 y pArg2 para cada tipo de evento diferente.
| uEvent | pArg1 | pArg2 |
|---|---|---|
| DSA_NOTIFY_DEL | Contiene el objeto eliminado. | No se usa. Será NULL. |
| DSA_NOTIFY_REN | Contiene el nombre anterior del objeto . | Contiene el nuevo nombre del objeto . |
| DSA_NOTIFY_MOV | Contiene el contenedor del que se mueve el objeto. | Contiene el contenedor al que se mueve el objeto. |
| DSA_NOTIFY_PROP | Contiene el objeto para el que han cambiado las propiedades. | No se usa. Será NULL. |
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | dsadmin.h |
| Archivo DLL | DSAdmin.dll |