Funzione RasSetEntryPropertiesA (ras.h)
La funzione RasSetEntryProperties modifica le informazioni di connessione per una voce nella rubrica o crea una nuova voce della rubrica telefonica.
Sintassi
DWORD RasSetEntryPropertiesA(
[in] LPCSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
[in] LPRASENTRYA unnamedParam3,
[in] DWORD unnamedParam4,
[in] LPBYTE unnamedParam5,
[in] DWORD unnamedParam6
);
Parametri
[in] unnamedParam1
Puntatore a una stringa con terminazione Null che specifica il percorso completo e il nome file di un file di rubrica telefonica (PBK). Se questo parametro è NULL, la funzione usa il file di rubrica predefinito corrente. Il file predefinito della rubrica telefonica è quello selezionato dall'utente nella finestra delle proprietà Preferenze utente della finestra di dialogo Rete remota.
[in] unnamedParam2
Puntatore a una stringa con terminazione Null che specifica un nome di voce.
Se il nome della voce corrisponde a una voce esistente, RasSetEntryProperties modifica le proprietà di tale voce.
Se il nome della voce non corrisponde a una voce esistente, RasSetEntryProperties crea una nuova voce della rubrica telefonica. Per le nuove voci, chiamare la funzione RasValidateEntryName per convalidare il nome della voce prima di chiamare RasSetEntryProperties.
[in] unnamedParam3
Puntatore alla struttura RASENTRY che specifica i nuovi dati di connessione da associare alla voce della rubrica telefonica indicata dal parametro lpszEntry .
Il chiamante deve specificare i valori per i membri seguenti nella struttura RASENTRY .
- dwSize
- szLocalPhoneNumber
- szDeviceName
- szDeviceType
- dwFramingProtocol
- dwfOptions
- dwType
Se i valori non vengono forniti per questi membri, RasSetEntryProperties ha esito negativo con ERROR_INVALID_PARAMETER.
La struttura può essere seguita da una matrice di stringhe di numeri di telefono alternativi con terminazione Null. L'ultima stringa viene terminata da due caratteri Null consecutivi. Il membro dwAlternateOffset della struttura RASENTRY contiene l'offset alla prima stringa.
[in] unnamedParam4
Specifica le dimensioni, in byte, del buffer identificato dal parametro lpRasEntry .
[in] unnamedParam5
Puntatore a un buffer che specifica le informazioni di configurazione specifiche del dispositivo. Si tratta di informazioni di configurazione del dispositivo TAPI opache. Per altre informazioni sulla configurazione del dispositivo TAPI, vedere la funzione lineGetDevConfig in Telephony Application Programming Interfaces (TAPI) in Platform SDK.
Windows XP: Questo parametro non è usato. La funzione chiamante deve impostare questo parametro su NULL.
[in] unnamedParam6
Specifica le dimensioni, in byte, del buffer lpbDeviceInfo .
Windows XP: Questo parametro non è usato. La funzione chiamante deve impostare questo parametro su zero.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Routing e Remote Access Error Codes o WinError.h.
Valore | Significato |
---|---|
|
L'utente non dispone dei privilegi corretti. Solo un amministratore può completare questa attività. |
|
L'indirizzo o il buffer specificato da lpRasEntry non è valido. |
|
La rubrica è danneggiata o mancante. |
|
La struttura RASENTRY a cui punta il parametro lpRasEntry non contiene informazioni adeguate o la voce specificata non esiste nella rubrica telefonica. Vedere la descrizione per lpRasEntry per visualizzare le informazioni necessarie. |
Commenti
Quando si impostano le proprietà per una connessione all-users, se l'applicazione chiamante specifica un valore diverso da NULL per il parametro phone-book, lpszPhonebook, il file della rubrica telefonica deve trovarsi nella directory rubrica telefonica sotto il percorso dati dell'applicazione all-users. Per ottenere la posizione corretta per il file della rubrica telefonica, chiamare prima SHGetFolderPath con un valore CSIDL di CSIDL_COMMON_APPDATA. SHGetFolderPath restituisce il percorso dei dati dell'applicazione all-users. Aggiungere la stringa seguente a questo percorso:
Microsoft\Network\Connections\Pbk
Il percorso combinato è il percorso corretto per il file della rubrica telefonica.
Nota
L'intestazione ras.h definisce RasSetEntryProperties come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
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 |