AuthResetRequest

9/8/2008

Essa função é disposto a funcionalidade solicitação Authentication Reset Component (ARC).

Syntax

HRESULT AuthResetRequest(
  HWND hWndParent,
  const BYTE* pbRequestData,
  DWORD cbRequestData,
    LPBYTE* ppbResetData,
  LPDWORD pcbResetData
);

Parameters

• hWndParent
  [no] Identificador para o janela pai. Pode ser NULL.

• pbRequestData
  [no] Ponteiro para os dados de solicitação. Para com êxito completo Authentication Reset, este valor deve ser os mesmos dados retornados por um bem-sucedido chamar para AuthResetSetup. O significado, tamanho e conteúdo de dados de solicitação é definidos pelo Authentication Reset Component (ARC).

• cbRequestData
  [no] Tamanho em Bytes da reserva apontada pelo pbRequestData.

• ppbResetData
  [out] Ponteiro para uma matriz byte que contém o Reset Data definido durante uma chamar para AuthResetSetup, se disponível. O chamador deve verificar que o conteúdo desta reserva correspondem a Reset Data originalmente fornecido antes de continuar etapas Authentication Reset. A reserva para a matriz byte será alocada por essa função. O chamador é responsável para livre esta reserva usando LocalFree. Se nenhum dado Reset estiver disponível, este argumento será apontar para NULL.

• pcbResetData
  [out] Tamanho em bytes de reserva de ppbResetData. Se nenhum dado Reset estiver disponível, pcbResetData será igual zero.

Declaração da função com anotações

HRESULT AuthResetRequest(__in_opt HWND hWndParent, __in_bcount(cbResetData) Const BYTE* pbRequestData, DWORD cbRequestData, __deref_out_bcount_opt(*pcbResetData) LPBYTE* ppbResetData, __out LPDWORD pcbResetData);

Return Value

Retorna S_OK se Authentication Reset é permitida para proceder. Neste maiúsculas e minúsculas, pbRequestData foi verificada e ppbResetData contém os dados Reset originalmente-fornecido. O LAP deve executar qualquer autenticação adicional necessário antes de continuar etapas Authentication Reset. Se Authentication Reset não pode proceder, um código de erro é retornado:

• HRESULT(ERROR_PRIVILEGE_NOT_HELD)
  A solicitação Authentication Reset é negado.

• HRESULT(ERROR_NOT_SUPPORTED)
  A diretiva do dispositivo e / ou configuração não permite Authentication Reset.

• HRESULT(ERROR_TOO_MANY_CMDS)
  O número de tentativas Authentication Reset solicitação foi excedido.

• HRESULT(ERROR_TOO_MANY_SESS)
  Outro segmento já está chamado AuthResetSetup ou AuthResetRequest.

• HRESULT(WAIT_TIMEOUT)
  O tempo limite de espera foi excedido.

• E_PENDING
  O Authentication Reset não pôde ser concluída nesse tempo. O usuário pode ser solicitado a aguardar ou executar alguma ação e, em seguida, tente novamente.

• E_ACCESSDENIED
  O chamador não é de confiança.

• E_POINTER
  Ponteiro inválido. É qualquer ppbResetData NULL ou pcbResetData é NULL. São válidos ponteiros para esses argumentos exigido.

• E_INVALIDARG
  Argumento inválido. é pbRequestData NULL ou cbResetData é 0. Não-zero valores para esses argumentos são exigido.

• E_ABORT
  O usuário cancelou o processo.

• E_OUTOFMEMORY
  O dispositivo é memória insuficiente.

• E_FAIL
  Erro não especificado.

Remarks

Um LAP deve chamar este API se um usuário solicitações para redefinir um token autenticação (por exemplo, eles tem perdido ou esquecer uma senha, cartão, etc.). Essa função irá determinar se o usuário é permitido para executar um Authentication Reset. Ele também será associado recuperar dados Reset se qualquer foram armazenados usando AuthResetSetup. Se for um chamar para AuthResetRequest bem-sucedido e Reset dados foram fornecidos anteriormente, os dados Reset são retornados o LAP deve verificar se esses dados correspondem os dados originally-supplied. O LAP também deve executar qualquer autenticação adicional necessário antes de continuar etapas Authentication Reset. O método usado para determinar se o usuário é permitido para executar Authentication Reset e os métodos de armazenar e recuperar Reset Data são a vontade da Authentication Reset Component.

Essa função falhará se a diretiva AuthenticationReset é definida como 0 (Authentication Reset não é permitido).

A funcionalidade usar como padrão solicita que o usuário para uma senha de recuperação que pode ser obtida um administrador sistema.

Esta API só pode ser chamado por de confiança processos.

Se um DeviceWipeThreshold tiver sido definido no dispositivo, este API será limite o número de falha tentativas Authentication Reset. Quando o limite for atingido, essa função sempre retornará HRESULT_FROM_WIN32(ERROR_TOO_MANY_CMDS).

Requirements

Header	aygshell.h
Library	Aygshell.dll
Windows Mobile	Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later, Windows Mobile 6 Standard and later

See Also

Reference

Authentication Reset System Functions
Authentication Reset System Reference

Concepts

Authentication Reset System