SetDefaultCommConfig

The SetDefaultCommConfig function sets the default configuration for a communications device.

BOOL SetDefaultCommConfig(
  LPCSTR lpszName,    // pointer to device name string
  LPCOMMCONFIG lpCC,  // pointer to structure
  DWORD dwSize        // size of structure
);
 

Parameters

lpszName

Pointer to a null-terminated string specifying the name of the device.

lpCC

Pointer to a COMMCONFIG structure.

dwSize

Specifies the size, in bytes, of the structure pointed to by lpCC.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winbase.h.
  Import Library: Use kernel32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Communications Overview, Communication Functions, GetDefaultCommConfig, COMMCONFIG