Partilhar via

Função AllocConnections

  • Artigo

Observação

A plataforma de Proteção de Acesso à Rede não está disponível a partir do Windows 10

A função AllocConnections aloca memória para um número especificado de estruturas connections .

Sintaxe

NAPAPI HRESULT WINAPI AllocConnections(
  _Inout_ Connections **connections,
  _In_    UINT16      connectionsCount
);

Parâmetros

conexões [in, out]

Um ponteiro para uma matriz de estruturas de Conexões recém-alocadas.

connectionsCount [in]

O número de estruturas a serem alocadas para conexões.

Valor retornado

Código de retorno Descrição
S_OK
 A operação foi concluída com êxito.
E_INVALIDARG
 Um argumento inválido foi passado.
E_OUTOFMEMORY
 O sistema está sem memória virtual. Esta operação falhou.

Comentários

Todas as interfaces COM compatíveis com o sistema NAP usam regras de gerenciamento de memória COM padrão e alocadores de memória COM (CoTaskMemAlloc e CoTaskMemFree):

  • Nos parâmetros, são alocados e liberados pelo chamador.
  • Os parâmetros out são alocados pelo receptor e liberados pelo chamador usando CoTaskMem.
  • Os parâmetros de entrada/saída são alocados pelo chamador, liberados e realocados pelo receptor e, por fim, liberados pelo chamador, usando CoTaskMem.

Todas as funções NAP para liberar memória também liberam todos os ponteiros inseridos.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
NapUtil.h
DLL
Qutil.dll

Confira também

FreeConnections