ARCSetup

9/8/2008

Essa função é implementada pelo Authentication Reset Component (ARC). Ele pode executar qualquer desejar a funcionalidade para permitir solicitações futuras Authentication Reset.

Syntax

HRESULT ARCSetup(
  HWND hWndParent,
  const BYTE* pbResetData,
  DWORD cbResetData,
  LPBYTE* ppbRequestData,
  LPDWORD pcbRequestData
);

Parameters

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

• pbResetData
  [no] Ponteiro opcional para Reset Data. O significado, tamanho e conteúdo de dados do Reset é definidos pelo chamador. Os dados mesmos serão retornados por um bem-sucedido chamar para ARCRequest. Pode ser NULL.

• cbResetData
  [no] Tamanho em Bytes da reserva apontada pelo pbResetData. Se não for pbResetData NULL, em seguida, este parâmetro não pode ser 0. Se estiver pbResetData NULL, em seguida, esse parâmetro é ignorado.

• ppbRequestData
  [out] Ponteiro para uma matriz byte que recebe os dados a ser usada durante uma chamar para ARCRequest. O significado, tamanho e conteúdo dos dados de solicitação é definidos pelo componente Reset de autenticação. O chamador é responsável por armazenando esse dados de forma segura e fornecendo-lo em chamadas subsequents para ARCReqeust. A reserva para a matriz byte é alocada por essa função. O chamador é responsável para livre esta reserva usando LocalFree.

• pcbRequestData
  [out] Ponteiro para uma variável que recebe o tamanho em Bytes da reserva apontado pelo parâmetro ppbRequestData.

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

PpbRequestData, __out pcbRequestData LPDWORD LPBYTE ARCSetup(__in_opt HWND hWndParent, __in_bcount_opt(cbResetData) Const BYTE* pbResetData, DWORD cbResetData, __deref_out_bcount (*pcbRequestData) HRESULT *);

Return Value

Retorna S_OK se instalação etapas foram concluídas com êxito, caso contrário-la pode retornar uma do seguinte códigos de erro:

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

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

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

• E_INVALIDARG
  Argumento inválido. Não é pbResetData NULL e cbResetData é 0. Essa condição não é permitida.

• 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 instalação Authentication Reset. LAPs não deve chamar esta função diretamente, como em vez disso, 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