ARCRequest

9/8/2008

Essa função é implementada pelo Authentication Reset Component (ARC). Ele pode executar qualquer desejado funcionalidade em ordem para determinar se o processo Authentication Reset é permitido.

Syntax

HRESULT ARCRequest(
  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 ARCSetup. 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 ARCSetup, 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 ARCRequest(__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 deve ter sido verificada e ppbResetData deve conter os dados Reset originalmente-fornecido. Se Authentication Reset não pode proceder, um código de erro é retornado. O código de erro deve ser HRESULT(ERROR_PRIVILEGE_NOT_HELD) se a solicitação é negado, mas pode conter informações de erro mais específicas. Exemplos:

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

• 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

Essa função é chamado pelo shell em resposta a uma solicitação de um LAP para redefinir autenticação do usuário a. LAPs não deve chamar esta função diretamente, eles devem usar AuthResetRequest.

Buffers retornados desta função devem ser alocados usando LocalAlloc.

O componente Authentication Reset pode exibir interface usuário e levar qualquer quantidade de tempo para completo essa função. Se usuário interface for exibida, a implementação deve fornecer uma maneira para o usuário para cancelar ou fornecer um mecanismo para telefone emergência local chama (em dispositivos de telefone). Todas as janelas devem ter o exstyle WS_EX_ABOVESTARTUP definido. Se o usuário cancela, esta função deve retornar E_ABORT.

Observação

Essa função é chamado pelo shell.Portanto, nenhuma biblioteca link é exposta.

Requirements

Header	aygshell.h
Windows Mobile	Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later, Windows Mobile 6 Standard and later
Note	This function is called by the Shell. Therefore, no link library is exposed.

See Also

Reference

Authentication Reset System Functions
Authentication Reset System Reference

Concepts

Authentication Reset System