Método IDsAdminNotifyHandler::Begin (dsadmin.h)
O método IDsAdminNotifyHandler::Begin é chamado quando um evento que o manipulador de notificação solicitou está ocorrendo. O manipulador de notificação especifica os eventos para os quais receber notificações quando IDsAdminNotifyHandler::Initialize for chamado.
Sintaxe
HRESULT Begin(
[in] ULONG uEvent,
[in] IDataObject *pArg1,
[in] IDataObject *pArg2,
[out] ULONG *puFlags,
[out] BSTR *pBstr
);
Parâmetros
[in] uEvent
Contém um valor que especifica o tipo de evento que está ocorrendo. Esse pode ser um dos valores a seguir.
DSA_NOTIFY_DEL
Um objeto é excluído.
DSA_NOTIFY_REN
Um objeto é renomeado.
DSA_NOTIFY_MOV
Um objeto é movido para outro contêiner.
DSA_NOTIFY_PROP
Uma ou mais propriedades de um objeto são modificadas.
[in] pArg1
Ponteiro para uma interface IDataObject que dá suporte ao formato de área de transferência CFSTR_DSOBJECTNAMES. O conteúdo do objeto de dados variará dependendo do valor de uEvent. Para obter mais informações, consulte a seção Comentários.
[in] pArg2
Ponteiro para uma interface IDataObject que dá suporte ao formato de área de transferência CFSTR_DSOBJECTNAMES. O valor desse parâmetro e o conteúdo do objeto de dados variam dependendo do valor de uEvent. Para obter mais informações, consulte a seção Comentários.
[out] puFlags
Ponteiro para um valor ULONG que recebe um conjunto de sinalizadores que modificam o comportamento do manipulador de notificação na caixa de diálogo de confirmação de notificação. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.
DSA_NOTIFY_FLAG_ADDITIONAL_DATA
Se esse sinalizador estiver definido, a entrada desse manipulador de notificação na caixa de diálogo de confirmação será selecionada. Se esse sinalizador não estiver definido, a entrada desse manipulador de notificação na caixa de diálogo de confirmação não será selecionada.
DSA_NOTIFY_FLAG_FORCE_ADDITIONAL_DATA
Se esse sinalizador estiver definido, a entrada desse manipulador de notificação na caixa de diálogo de confirmação será desabilitada e o usuário não poderá alterar o estado de seleção.
[out] pBstr
Ponteiro para um BSTR que recebe uma cadeia de caracteres que contém o nome e/ou a descrição do manipulador de notificação. Essa cadeia de caracteres é exibida na caixa de diálogo de confirmação. Essa cadeia de caracteres deve ser alocada chamando a função SysAllocString . O chamador deve liberar essa cadeia de caracteres quando ela não for mais necessária. Se esse parâmetro receber NULL ou uma cadeia de caracteres vazia, o manipulador de notificação não será adicionado à caixa de diálogo de confirmação e IDsAdminNotifyHandler::Notify não será chamado.
Valor retornado
Se o método for bem-sucedido, S_OK será retornado. Se o método falhar, um valor HRESULT padrão será retornado.
Comentários
O valor e o conteúdo de pArg1 e pArg2 variam dependendo do evento processado conforme indicado por uEvent. A lista a seguir explica o que pArg1 e pArg2 conterão para cada tipo de evento diferente.
| uEvent | pArg1 | pArg2 |
|---|---|---|
| DSA_NOTIFY_DEL | Contém o objeto excluído. | Não usado. Isso será NULL. |
| DSA_NOTIFY_REN | Contém o nome anterior do objeto. | Contém o novo nome do objeto. |
| DSA_NOTIFY_MOV | Contém o contêiner do qual o objeto é movido. | Contém o contêiner para o qual o objeto é movido. |
| DSA_NOTIFY_PROP | Contém o objeto para o qual as propriedades foram alteradas. | Não usado. Isso será NULL. |
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | dsadmin.h |
| DLL | DSAdmin.dll |