Função LPM_Initialize (lpmapi.h)

A função LPM_Initialize inicializa um LPM (módulo de política local). Isso ocorre quando o Serviço de Controle de Admissão precisa fazer o controle de política baseado em admissão, como quando um SBM se torna o DSBM (Gerenciador de Largura de Banda de Sub-Rede Designado). Os LPMs devem inicializar-se, de forma síncrona, antes de retornar.

Sintaxe

ULONG LPM_Initialize(
  [in]  LPM_HANDLE    LpmHandle,
  [in]  LPM_INIT_INFO *pLpmInitInfo,
  [out] DWORD         *pLpmVersionNumber,
  [out] PETYPE        *pSupportedPeType,
  [out] VOID          *Reserved
);

Parâmetros

[in] LpmHandle

Identificador exclusivo para o LPM, atribuído pelo PCM.

[in] pLpmInitInfo

Ponteiro para uma estrutura de LPM_INIT_INFO que contém informações de inicialização do LPM.

[out] pLpmVersionNumber

Versão do LPM que está sendo solicitada.

[out] pSupportedPeType

Tipo de PE (elemento de política) válido que o LPM usa para tomar decisões de controle de admissão baseadas em política. Cada LPM só pode dar suporte a um tipo PE, embora versões futuras possam permitir que um LPM dê suporte a vários tipos pe. Os tipos de PE reservados são definidos em Lpmapi.h. Para obter mais informações sobre tipos de elementos de política, consulte Elementos de política.

É possível que uma única DLL dê suporte a vários tipos pe, tendo o nome DLL inserido várias vezes nos dados de configuração do PCM. Nessas circunstâncias, o PCM carregará e chamará a mesma rotina LPM_Initialize várias vezes; é responsabilidade do LPM retornar diferentes tipos de PE para essas chamadas adicionais.

Os LPMs podem retornar um tipo PE especial, LPM_ALL_PE_TYPES, para indicar que ele tomará decisões de controle de admissão baseadas em política com base em todos os objetos de dados de política. Nesse cenário, o PCM assumirá que esse LPM entende como gerar objetos de dados de política para mensagens de saída que o PCM não consegue entender.

[out] Reserved

Reservado para uso futuro.

Valor retornado

Se o LPM for inicializado com êxito e um tipo PE válido for retornado em pSupportedPeType, o valor retornado será LPM_OK. O PCM trata qualquer valor diferente de LPM_OK como um erro e descarrega a DLL (LPMs são sempre implementados como DLLs). Se um valor diferente de LPM_OK for retornado ou pSupportedPeType for inválido, o PCM gravará um registro no Log de Eventos e incluirá o nome da DLL e o valor de erro retornado.

Requisitos

Confira também

LPM_AdmitRsvpMsg

LPM_GetRsvpObjects

PALLOCMEM

PFREEMEM