GetCommProperties 函式 (winbase.h)

擷取指定通訊裝置之通訊屬性的相關信息。

語法

BOOL GetCommProperties(
  [in]  HANDLE     hFile,
  [out] LPCOMMPROP lpCommProp
);

[in] hFile

通訊裝置的句柄。 CreateFile 函式會傳回這個句柄。

[out] lpCommProp

COMMPROP 結構的指標，其中會傳回通訊屬性資訊。這項資訊可用於後續對 SetCommState、 SetCommTimeouts 或 SetupComm 函式的呼叫，以設定通訊裝置。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

GetCommProperties 函式會從設備驅動器傳回驅動程式所支援之組態設定的相關信息。

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll