Funzione RasGetSubEntryPropertiesA (ras.h)
La funzione RasGetSubEntryProperties recupera informazioni su una sottoentrezione per una voce di rubrica telefonica specificata.
Sintassi
DWORD RasGetSubEntryPropertiesA(
[in] LPCSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
[in] DWORD unnamedParam3,
[in, out] LPRASSUBENTRYA unnamedParam4,
[in, out] LPDWORD unnamedParam5,
[in] LPBYTE unnamedParam6,
[in] LPDWORD unnamedParam7
);
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.
Windows Me/98/95: Questo parametro deve essere sempre NULL. La rete di connessione remota archivia le voci della rubrica 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 della sottoentità.
[in, out] unnamedParam4
Puntatore alla struttura RASSUBENTRY seguita da byte aggiuntivi per l'elenco di numeri di telefono alternativi, se presente.
Nell'output, la struttura riceve informazioni sulla sottoentria specificata.
In input, il membro dwSize specifica le dimensioni della struttura. La dimensione identifica la versione della struttura. Ottenere queste dimensioni usando sizeof(RASSUBENTRY).
Questo parametro può essere NULL.
[in, out] unnamedParam5
Puntatore a una variabile che specifica, in input, le dimensioni, in byte, del buffer lpRasSubEntry .
Nell'output, la variabile riceve il numero di byte restituiti o il numero di byte necessari se il buffer è troppo piccolo.
Questo parametro può essere NULL se lpRasSubEntry è NULL.
[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 del dispositivo TAPI, vedere la riga della funzioneGetDevConfig.
[in] unnamedParam7
Puntatore a un DWORD che specifica le dimensioni del blocco di configurazione del dispositivo TAPI. Questo parametro è attualmente inutilizzato. Il chiamante deve passare NULL per questo parametro.
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 |
---|---|
|
La funzione è stata chiamata con un parametro non valido. |
|
L'indirizzo o il buffer specificato da lpRasSubEntry non è valido. |
|
Il buffer lpRasSubEntry è troppo piccolo. La variabile lpdwcb riceve le dimensioni del buffer necessarie. |
|
La rubrica è danneggiata o manca componenti. |
|
La voce della rubrica telefonica non esiste. |
Commenti
Una voce di rubrica RAS può avere zero o più sottoinsieme, ognuna costituita minimamente da un dispositivo e da un numero di telefono. È possibile configurare una voce della rubrica telefonica con più sottoinsieme per comporre la prima voce disponibile o tutte le sottoinsieme quando si compone la voce.
Utilizzare la funzione RasGetEntryProperties per recuperare una struttura RASENTRY contenente informazioni sulle voci secondarie di una voce della 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 RasGetSubEntryProperties 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
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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere:Invia e visualizza il feedback per