Funzione RasSetSubEntryPropertiesA (ras.h)
La funzione RasSetSubEntryProperties crea una nuova sottoentry o modifica una sottoentry esistente di una voce di rubrica telefonica specificata.
Sintassi
DWORD RasSetSubEntryPropertiesA(
[in] LPCSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
[in] DWORD unnamedParam3,
[in] LPRASSUBENTRYA unnamedParam4,
[in] DWORD unnamedParam5,
[in] LPBYTE unnamedParam6,
[in] DWORD unnamedParam7
);
Parametri
[in] unnamedParam1
Puntatore a una stringa con terminazione null che specifica il percorso completo e il nome file di un file PBK (Phone Book). Se questo parametro è NULL, la funzione usa il file di rubrica telefonico predefinito corrente. Il file di rubrica telefonico predefinito è quello selezionato dall'utente nella finestra di proprietà Preferenze utente della finestra di dialogo Rete remota .
Windows Me/98/95: Questo parametro deve sempre essere NULL. La rete con accesso esterno archivia le voci della rubrica telefonica nel Registro di sistema anziché in un file di rubrica telefonica.
[in] unnamedParam2
Puntatore a una stringa con terminazione null che specifica il nome di una voce esistente nella rubrica telefonica.
[in] unnamedParam3
Specifica l'indice in base uno del sottoentrio. Se l'indice corrisponde a un indice secondario esistente, la funzione modifica le proprietà di tale sottoentrio. Se l'indice non corrisponde a un indice esistente, la funzione crea una nuova sottoentria.
[in] unnamedParam4
Puntatore alla struttura RASSUBENTRY che specifica i dati per la sottoentria.
La struttura potrebbe 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 RASSUBENTRY contiene l'offset alla prima stringa.
[in] unnamedParam5
Specifica le dimensioni, in byte, del buffer lpRasSubEntry .
[in] unnamedParam6
Puntatore a un blocco di configurazione del dispositivo TAPI. Questo parametro è attualmente inutilizzato. Il chiamante deve passare NULL per questo parametro. Per altre informazioni sui blocchi di configurazione dei dispositivi TAPI, vedere la riga di funzioneGetDevConfig.
[in] unnamedParam7
Specifica le dimensioni del blocco di configurazione del dispositivo TAPI. Questo parametro è attualmente inutilizzato. Il chiamante deve passare zero per questo parametro.
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 |
---|---|
|
L'indirizzo o il buffer specificato da lpRasEntry non è valido. |
|
La voce della rubrica telefonica non esiste. |
|
Il telefono è danneggiato o mancante componenti. |
|
La funzione è stata chiamata con un parametro non valido. |
Commenti
Una voce della rubrica ras può avere zero o più sottoinsieme, ognuna costituita minimamente da un dispositivo e da un numero di telefono. È possibile configurare una voce di rubrica telefonica con più sottoinsieme per comporre la prima sottoentria disponibile o tutte le sottoinsieme quando la voce viene chiamata.
Utilizzare la funzione RasGetEntryProperties per recuperare la struttura RASENTRY contenente informazioni sulle voci secondarie di una voce di rubrica telefonica. Il membro dwSubEntries indica il numero di voci secondarie e il membro dwDialMode indica la configurazione di composizione.
Nota
L'intestazione ras.h definisce RasSetSubEntryProperties 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 |