GetCommState Function
Retrieves the current control settings for a specified communications device.
특정 통신 장치의 현재 관리 설정을 추출한다.BOOL WINAPI GetCommState(
__in HANDLE hFile,
__inout LPDCB lpDCB
);
Parameters(매개변수)
- hFile
- A handle to the communications device. The CreateFile function returns this handle.
- 통신 장치에 대한 핸들. CreateFile 함수가 이 핸들을 반환한다.
- lpDCB
- A pointer to a DCB structure that receives the control settings information.
- 관리 설정 정보를 돌려받는 DCB 구조에 대한 포인터.
Return Value(반환 값)
If the function succeeds, the return value is nonzero.
만약 함수가 성공하면, 반환 값은 nonzero.
If the function fails, the return value is zero. To get extended error information, call
GetLastError.
만약 함수가 실패하면, 반환 값은 zero. 상세한 에러 정보를 얻으려면, GetLastError을 호출하라.
Example Code
For an example, see Configuring a Communications Resource.
Requirements
| Client | Requires Windows Vista, Windows XP, or Windows 2000 Professional. |
|---|---|
| Server | Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server. |
| Header | Declared in Winbase.h; include Windows.h. |
| Library | Use Kernel32.lib. |
| DLL | Requires Kernel32.dll. |
See Also
Communications Functions
Communications Resources
CreateFile
DCB
SetCommState
Send comments about this topic to Microsoft
Build date: 12/20/2007
이올린에 북마크하기

