SetDefaultCommConfig

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

BOOL SetDefaultCommConfig(
  LPCTSTR lpszName,    // device name string
  LPCOMMCONFIG lpCC,   // configuration information
  DWORD dwSize         // size of structure
);

Parameters

lpszName

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

lpCC

[in] Pointer to a COMMCONFIG structure.

dwSize

[in] 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.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Kernel32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

Communications Overview, Communication Functions, GetDefaultCommConfig, COMMCONFIG