Funzione MprAdminGetIpAddressForUser (mprapi.h)

Articolo
08/24/2023

RAS chiama la funzione MprAdminGetIpAddressForUser una volta per ogni utente che richiede un indirizzo IP. RAS chiama la funzione con l'indirizzo IP 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 MprAdminGetIpAddressForUser(
  [in]      WCHAR *lpwszUserName,
  [in]      WCHAR *lpwszPortName,
  [in, out] DWORD *lpdwIpAddress,
  [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] lpdwIpAddress

All'input, puntatore a una variabile DWORD che contiene zero o l'indirizzo IP ras allocato per l'utente.

Nell'output, se RAS ha specificato zero, la DLL alloca un indirizzo IP per l'utente. In questo caso, se la DLL non alloca un indirizzo IP, l'utente non è in grado di connettersi. Se RAS ha specificato un indirizzo IP, 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 MprAdminReleaseIpAddress 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

RAS supporta più DLL di amministrazione. Tuttavia, RAS chiama MprAdminGetIpAddressForUser solo nella prima DLL che lo implementa ed esporta. RAS ignora le implementazioni di queste funzioni nelle altre DLL. RAS controlla le DLL per queste funzioni nell'ordine in cui sono elencate nel Registro di sistema.

Una DLL di amministrazione non deve implementare la funzione MprAdminGetIpAddressForUser . Tuttavia, se la DLL implementa MprAdminGetIpAddressForUser, deve implementare anche MprAdminReleaseIpAddress.

Non chiamare funzioni di amministrazione RAS o funzioni di amministrazione utente RAS dall'interno di MprAdminGetIpAddressForUser. Le chiamate a queste funzioni non verranno restituite quando effettuate dall'interno di una funzione di callout.

Requisiti


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

Vedi anche

MprAdminReleaseIpAddress

DLL di amministrazione RAS

Funzioni di amministrazione RAS

Informazioni di riferimento per l'amministrazione del servizio Accesso remoto

Condividi tramite