Funzione GetDefaultCommConfigA (winbase.h)
Recupera la configurazione predefinita per il dispositivo di comunicazione specificato.
Sintassi
BOOL GetDefaultCommConfigA(
[in] LPCSTR lpszName,
[out] LPCOMMCONFIG lpCC,
[in, out] LPDWORD lpdwSize
);
Parametri
[in] lpszName
Nome del dispositivo. Ad esempio, COM1 a COM9 sono porte seriali e LPT1 a LPT9 sono porte parallele.
[out] lpCC
Puntatore a un buffer che riceve una struttura
[in, out] lpdwSize
Puntatore a una variabile che specifica le dimensioni del buffer a cui punta lpCC, in byte. Al termine della restituzione, la variabile contiene il numero di byte copiati se la funzione ha esito positivo o il numero di byte necessari se il buffer è troppo piccolo.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, usare la funzione GetLastError.
Osservazioni
Nota
L'intestazione winbase.h definisce GetDefaultCommConfig 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP |
| server minimo supportato | Windows Server 2003 |
| piattaforma di destinazione | Finestre |
| intestazione |
winbase.h (include Windows.h) |
| libreria |
Kernel32.lib |
| dll | Kernel32.dll |