Funzione AllocConnections

Nota

La piattaforma Protezione accesso alla rete non è disponibile a partire da Windows 10

La funzione AllocConnections alloca memoria per un numero specificato di strutture Connections .

Sintassi

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

Parametri

connessioni [in, out]

Puntatore a una matrice di strutture Connessioni appena allocate.

connectionsCount [in]

Numero di strutture da allocare alle connessioni.

Valore restituito

Codice restituito Descrizione
S_OK
L'operazione è stata completata correttamente.
E_INVALIDARG
È stato passato un argomento non valido.
E_OUTOFMEMORY
Il sistema non è in memoria virtuale. Questa operazione non è riuscita.

Commenti

Tutte le interfacce COM supportate dal sistema Protezione accesso alla rete usano regole di gestione della memoria COM standard e gli allocatori di memoria COM (CoTaskMemAlloc e CoTaskMemFree):

  • Nei parametri vengono allocati e liberati dal chiamante.
  • I parametri out vengono allocati dal chiamato e liberati dal chiamante usando CoTaskMem.
  • I parametri in/out vengono allocati dal chiamante, liberati e riallocati dal chiamato e infine liberati dal chiamante, usando CoTaskMem.

Tutte le funzioni protezione accesso alla rete per liberare memoria liberano anche tutti i puntatori incorporati.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2008 [solo app desktop]
Intestazione
NapUtil.h
DLL
Qutil.dll

Vedi anche

FreeConnections