Método IMbnPinEvents::OnEnterComplete (mbnapi.h)
Importante
A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.
Método de notificação chamado pelo serviço de Banda Larga Móvel para indicar que uma operação de entrada de PIN foi concluída
Sintaxe
HRESULT OnEnterComplete(
[in] IMbnPin *Pin,
[in] MBN_PIN_INFO *pinInfo,
[in] ULONG requestID,
[in] HRESULT status
);
Parâmetros
[in] Pin
Uma interface IMbnPin que representa o tipo de PIN.
[in] pinInfo
Um ponteiro para uma estrutura MBN_PIN_INFO que contém informações sobre as tentativas restantes, em caso de operações de falha. O conteúdo de pinInfo só é significativo quando status é E_MBN_FAILURE.
[in] requestID
Uma ID de solicitação definida pelo serviço de Banda Larga Móvel para identificar a solicitação de inserção de PIN.
[in] status
Um código status que indica o resultado da operação.
Um aplicativo de chamada pode esperar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
A operação foi bem-sucedida. |
|
O dispositivo não dá suporte a essa operação. |
|
Não foi possível concluir a operação. |
|
Um PIN é necessário para que a operação seja concluída. O aplicativo de chamada pode chamar o método GetPinState de IMbnPinManager para descobrir o tipo de PIN esperado. |
|
Não há nenhum SIM no dispositivo. |
|
Há um SIM inválido no dispositivo. |
Valor retornado
Esse método deve retornar S_OK.
Comentários
O método OnEnterComplete é chamado pelo serviço de Banda Larga Móvel para relatar o status de conclusão de uma operação de entrada de PIN inicializada por uma chamada para o método Enter de IMbnPin.
O conteúdo de pinInfo só é significativo quando status é E_MBN_FAILURE. O membro pinState deve ser ignorado e o campo pinType é definido como o tipo de PIN da interface IMbnPin atual. Essa estrutura contém as tentativas restantes de inserir um PIN válido.
Por exemplo, se o PIN passado para alterar um tipo de PIN estiver incorreto, a operação falhará com um código de status de E_MBN_FAILURE. Nesse caso, pinInfo.attemptsRemaining especifica o número de tentativas restantes para repetir essa operação. Se tentativas repetidas com o PIN errado fizerem com que attemptsRemaining se torne 0, o aplicativo poderá chamar o método GetPinState de IMbnPinManager para obter o tipo de PIN necessário.
Requisitos
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |