Partilhar via


Função de retorno de chamada CBADMITRESULT (lpmapi.h)

A função cbAdmitResult é usada por LPMs para retornar resultados para a solicitação de LPM_AdmitRsvpMsg . Os LPMs só devem usar essa função se retornarem LPM_RESULT_DEFER para a chamada de função LPM_AdmitRsvpMsg . O PCM só aceitará resultados dessa função dentro do limite de tempo de resultado estabelecido por cada LPM por meio do parâmetro ResultTimeLimit da função LPM_Initialize .

Sintaxe

CBADMITRESULT Cbadmitresult;

ULONG * Cbadmitresult(
  [in] LPM_HANDLE LpmHandle,
  [in] RHANDLE RequestHandle,
  [in] ULONG ulPcmActionFlags,
  [in] int LpmError,
  [in] int PolicyDecisionsCount,
  [in] POLICY_DECISION *pPolicyDecisions
)
{...}

Parâmetros

[in] LpmHandle

Identificador exclusivo para o LPM, conforme fornecido em LPM_Initialize. O PCM ignorará qualquer resultado que não seja acompanhado por um identificador LPM válido.

[in] RequestHandle

Identificador exclusivo que distingue essa solicitação de todas as outras solicitações. Os LPMs devem passar esse identificador para o PCM ao retornar resultados de forma assíncrona para uma solicitação individual chamando cbAdmitResult. O parâmetro RequestHandle se torna inválido quando os resultados são retornados, exigindo que cada solicitação obtenha seu próprio RequestHandle exclusivo do PCM.

[in] ulPcmActionFlags

Sinalizadores de ação do Módulo de Controle de Política.

[in] LpmError

Código de erro LPM. Deve ser uma destas opções:

Valor Significado
INV_LPM_HANDLE
O identificador LPM fornecido é inválido.
LPM_TIME_OUT
O LPM retornou resultados após o limite de tempo.
INV_REQ_HANDLE
O identificador de solicitação fornecido é inválido.
DUP_RESULTS
O LPM já retornou os resultados dessa solicitação.
INV_RESULTS
Os resultados fornecidos são inválidos.

[in] PolicyDecisionsCount

O número de decisões de política fornecidas em pPolicyDecisions.

[in] pPolicyDecisions

Decisões políticas, na forma de uma ou mais estruturas POLICY_DECISION .

Retornar valor

Essa função de retorno de chamada não retorna um valor.

Comentários

Quando uma solicitação for rejeitada, o PCM chamará o LPM para instruí-lo a excluir o estado da solicitação. O LPM pode optar por excluir o estado da solicitação a qualquer momento durante o processo de rejeição. Se o LPM excluir o estado de uma solicitação logo após a rejeição da solicitação, o LPM deverá estar preparado para lidar com chamadas subsequentes (pelo PCM, por meio da função LPM_DeleteState ) para excluir o estado (já excluído).

O LPM não precisa manter o estado das solicitações às quais retorna LPV_DONT_CARE. No entanto, o LPM deve estar preparado para lidar com LPM_DeleteState solicitações para esse estado (inexistente).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho lpmapi.h

Confira também

LPM_AdmitRsvpMsg

LPM_DeleteState

LPM_Initialize