Função de retorno de chamada BFFCALLBACK (shlobj_core.h)
A função BFFCallBack é uma função de retorno de chamada definida pelo aplicativo que recebe notificações de eventos da caixa de diálogo do navegador do contêiner Active Directory Domain Services. Um ponteiro para essa função é fornecido para a caixa de diálogo do navegador do contêiner no membro pfnCallback da estrutura DSBROWSEINFO quando a função DsBrowseForContainer é chamada. BFFCallBack é um espaço reservado para o nome da função definida pelo aplicativo.
Sintaxe
BFFCALLBACK Bffcallback;
int Bffcallback(
[in] HWND hwnd,
[in] UINT uMsg,
[in] LPARAM lParam,
[in] LPARAM lpData
)
{...}
Parâmetros
[in] hwnd
Contém o identificador de janela da caixa de diálogo Procurar. Esse identificador é usado para enviar mensagens para a caixa de diálogo procurar usando a função SendMessage .
A caixa de diálogo do navegador de contêiner manipula as mensagens a seguir.
BFFM_ENABLEOK
Essa mensagem habilita ou desabilita o botão de comando OK na caixa de diálogo.
O wParam desta mensagem contém um valor booliano que, se zero, desabilita o botão de comando OK . Se o wParam for diferente de zero, o botão de comando OK estará habilitado. Por padrão, o botão de comando OK está habilitado.
O valor retornado para esta mensagem não é usado.
BFFM_SETSELECTION
Esta mensagem seleciona um item na caixa de diálogo.
O lParam dessa mensagem é um ponteiro para uma cadeia de caracteres TCHAR que contém o ADsPath do item a ser selecionado. Embora haja versões ANSI e Unicode dessa mensagem, ambas as versões levam um ponteiro para uma cadeia de caracteres Unicode.
O valor retornado para esta mensagem não é usado.
[in] uMsg
Especifica uma das mensagens de navegação a seguir.
BFFM_INITIALIZED
Essa notificação é enviada depois que a caixa de diálogo é inicializada.
LParam não é usado.
O valor retornado dessa notificação é ignorado.
BFFM_SELCHANGED
Essa notificação é enviada depois que a seleção na caixa de diálogo é alterada.
lParam é um ponteiro para uma cadeia de caracteres Unicode que contém o ADsPath do item recém-selecionado.
O valor retornado dessa notificação é ignorado.
DSBM_CHANGEIMAGESTATE
Reservado.
DSBM_CONTEXTMENU
Essa notificação é enviada quando a caixa de diálogo recebe uma mensagem WM_CONTEXTMENU .
lParam é o valor wParam passado com a mensagem WM_CONTEXTMENU .
O valor retornado dessa notificação é ignorado.
DSBM_HELP
Essa notificação é enviada quando a caixa de diálogo recebe uma mensagem WM_HELP .
lParam é o valor lParam passado com a mensagem WM_HELP .
O valor retornado dessa notificação é ignorado.
DSBM_QUERYINSERT
Essa notificação é enviada antes de cada objeto de contêiner ser inserido na árvore. O aplicativo pode usar essa notificação para modificar o conteúdo da caixa de diálogo.
lParam é um ponteiro para uma estrutura DSBITEM que contém dados sobre o item inserido. Alguns membros dessa estrutura, como szDisplayName, podem ser modificados durante essa notificação para alterar a maneira como os itens são exibidos.
Retornará um valor diferente de zero dessa notificação se os dados na estrutura DSBITEM forem alterados. Retornará zero se a hora precisar ser inserida inalterada.
[in] lParam
O valor e o significado desse parâmetro são determinados pela notificação recebida. Para obter mais informações, consulte as descrições da mensagem de notificação no parâmetro uMsg .
[in] lpData
Contém um ponteiro para a estrutura DSBROWSEINFO passada para a função DsBrowseForContainer . Isso é verdadeiro para todas as mensagens de notificação.
Valor retornado
Nenhum
Comentários
Os valores da mensagem DSBM_* são definidos em Dsclient.h.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | shlobj_core.h |