Funzione RasGetCustomAuthDataA (ras.h)

  • Articolo

Usare la funzione RasGetCustomAuthData per recuperare informazioni di autenticazione specifiche della connessione. Queste informazioni non sono specifiche di un determinato utente.

Sintassi

DWORD RasGetCustomAuthDataA(
  [in]      LPCSTR pszPhonebook,
  [in]      LPCSTR pszEntry,
  [out]     BYTE   *pbCustomAuthData,
  [in, out] DWORD  *pdwSizeofCustomAuthData
);

Parametri

[in] pszPhonebook

Puntatore a una stringa con terminazione null che specifica il percorso completo del file PBK (phone-book). Se questo parametro è NULL, la funzione usa la rubrica telefonica del sistema.

[in] pszEntry

Puntatore a una stringa con terminazione null che specifica un nome di voce esistente.

[out] pbCustomAuthData

Puntatore a un buffer che riceve i dati di autenticazione. Il chiamante deve allocare la memoria per questo buffer. Se il buffer non è sufficiente, RasGetCustomAuthData restituisce ERROR_BUFFER_TOO_SMALL e il parametro pdwSizeofEapData contiene le dimensioni necessarie.

[in, out] pdwSizeofCustomAuthData

Puntatore a una variabile DWORD che, in input, specifica le dimensioni del buffer a cui punta il parametro pbCustomAuthData .

Se il buffer specificato dal parametro pbCustomAuthData non è sufficiente, pdwSizeofEapData riceve, nell'output, le dimensioni necessarie.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore da Routing e codici di errore di accesso remoto o Winerror.h.

Valore Significato
E_INVALIDARG
 Il parametro pdwSizeofCustomAuthData è NULL.
ERROR_BUFFER_TOO_SMALL
 Il buffer a cui fa riferimento pbCustomAuthData è troppo piccolo per ricevere i dati. PdwSizeofCustomAuthData contiene le dimensioni necessarie.
ERROR_CANNOT_OPEN_PHONEBOOK

RasGetEapUserData non è stato in grado di aprire il file di rubrica telefonico specificato.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY

RasGetEapUserData non è riuscito a trovare la voce specificata nella rubrica telefonica.
Altri
 Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

Nota

L'intestazione ras.h definisce RasGetCustomAuthData come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ras.h
Libreria Rasapi32.lib
DLL Rasapi32.dll

Vedi anche

RasGetEapUserData

RasSetCustomAuthData