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, DA COM1 a COM9 sono porte seriali e LPT1 da LPT9 a LPT9 sono porte parallele.

[out] lpCC

Puntatore a un buffer che riceve una struttura COMMCONFIG .

[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 sull'errore estese, usare la funzione GetLastError .

Commenti

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 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 XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

COMMCONFIG

Funzioni di comunicazione

Risorse di comunicazione

SetDefaultCommConfig