Funzione MprAdminGetIpv6AddressForUser (mprapi.h)

Articolo
08/24/2023

RAS chiama la funzione MprAdminGetIpv6AddressForUser una volta per ogni utente che richiede un indirizzo IPv6. RAS chiama la funzione con l'indirizzo IPv6 selezionato da RAS per l'utente. La DLL di terze parti che implementa questa funzione può modificare questo indirizzo in una delle proprie scelte.

Sintassi

DWORD MprAdminGetIpv6AddressForUser(
  [in]      WCHAR    *lpwszUserName,
  [in]      WCHAR    *lpwszPortName,
  [in, out] IN6_ADDR *lpdwIpv6Address,
  [out]     BOOL     *bNotifyRelease
);

Parametri

[in] lpwszUserName

Puntatore a una stringa Unicode che specifica il nome dell'utente che richiede un indirizzo IP.

[in] lpwszPortName

Puntatore a una stringa Unicode che specifica il nome della porta in cui l'utente sta tentando di connettersi.

[in, out] lpdwIpv6Address

Puntatore a una struttura in6_addr che contiene zero o l'indirizzo RAS di indirizzo IPv6 allocato per l'utente.

Attualmente sono supportati solo gli identificatori a 64 bit.

Nell'output, se RAS ha specificato zero, la DLL alloca un indirizzo IPv6 per l'utente. In questo caso, se la DLL non alloca un indirizzo IPv6, l'utente non è in grado di connettersi. Se RAS ha specificato un indirizzo IPv6, la DLL accetta l'indirizzo o ne sostituisce uno diverso.

[out] bNotifyRelease

Puntatore a una variabile BOOL . Se la DLL imposta questa variabile su TRUE, RAS chiama MprAdminReleaseIpv6AddressForUser quando l'utente si disconnette. In caso contrario, RAS non invia una notifica alla DLL quando viene rilasciato questo indirizzo IP.

Valore restituito

Se la funzione ha esito positivo, il valore restituito deve essere NO_ERROR.

Se la funzione restituisce qualsiasi valore diverso da NO_ERROR, RAS terminerà la connessione.

Commenti

Una DLL di amministrazione non deve implementare la funzione MprAdminGetIpv6AddressForUser . Tuttavia, se la DLL implementa MprAdminGetIpv6AddressForUser, deve implementare anche MprAdminReleaseIpv6AddressForUser.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h

Vedi anche

MprAdminReleaseIpv6AddressForUser

DLL di amministrazione RAS

Funzioni di amministrazione RAS

Informazioni di riferimento per l'amministrazione del servizio Accesso remoto

Condividi tramite