Condividi tramite

Funzione di callback RasAdminReleaseIpAddress

  • Articolo

[La funzione RasAdminReleaseIpAddress è disponibile per l'uso in Windows NT 4.0 e non è disponibile nelle versioni successive. Usare invece MprAdminReleaseIpAddress.]

La funzione RasAdminReleaseIpAddress è una funzione definita dall'applicazione esportata da una DLL di amministrazione del server RAS di terze parti. RAS chiama questa funzione per notificare alla DLL che il client remoto è stato disconnesso e che l'indirizzo IP deve essere rilasciato.

Sintassi

void CALLBACK RasAdminReleaseIpAddress(
  _In_ WCHAR  *lpszUserName,
  _In_ WCHAR  *lpszPortName,
  _In_ IPADDR *pipAddress
);

Parametri

lpszUserName [in]

Specifica il puntatore a una stringa Unicode con terminazione Null che specifica il nome di un utente remoto per il quale in precedenza è stato ottenuto un indirizzo IP usando la funzione RasAdminGetIpAddressForUser .

lpszPortName [in]

Puntatore a una stringa Unicode con terminazione Null che specifica il nome della porta in cui è connesso l'utente specificato da lpszUserName .

pipAddress [in]

Puntatore a una variabile IPADDR che specifica l'indirizzo IP restituito per questo utente in una chiamata precedente a RasAdminGetIpAddressForUser.

Valore restituito

Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.

Commenti

Il server RAS chiama la funzione RasAdminReleaseIpAddress solo se l'applicazione ha restituito TRUE nel parametro bNotifyRelease durante la chiamata precedente a RasAdminGetIpAddressForUser per l'utente specificato dal parametro lpszUserName .

Il programma di installazione per una DLL di amministrazione RAS di terze parti deve registrare la DLL con RAS fornendo informazioni nella chiave seguente nel Registro di sistema:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

Per registrare la DLL, impostare i valori seguenti in questa chiave.

Nome del valore Dati del valore
DisplayName Stringa REG_SZ contenente il nome visualizzato descrittivo della DLL.
DLLPath Stringa REG_SZ che contiene il percorso completo della DLL.

 

Ad esempio, la voce del Registro di sistema per una DLL di amministrazione RAS di una società fittizia denominata ProElectron, Inc. potrebbe essere:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

DisplayName: REG_SZ : ProElectron RAS Amministrazione DLL DllPath: REG_SZ : C:\nt\system32\ntwkadm.dll

Anche il programma di installazione per una DLL di amministrazione RAS deve fornire funzionalità di rimozione/disinstallazione. Se un utente rimuove la DLL, il programma di installazione deve eliminare le voci del Registro di sistema della DLL.