TSPI_lineGetIcon 함수(tspi.h)
TSPI_lineGetIcon 함수는 사용자에게 표시할 서비스 라인 디바이스별 아이콘을 검색합니다.
구문
LONG TSPIAPI TSPI_lineGetIcon(
DWORD dwDeviceID,
LPCWSTR lpszDeviceClass,
LPHICON lphIcon
);
매개 변수
dwDeviceID
아이콘이 요청된 줄 디바이스입니다.
lpszDeviceClass
디바이스 클래스 이름을 식별하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 디바이스 클래스를 사용하면 호출자가 해당 디바이스 클래스와 관련된 아이콘을 선택할 수 있습니다. 이 매개 변수는 선택 사항이며 NULL로 남겨둘 수 있습니다. 이 경우 지정된 미디어 스트림 디바이스가 아닌 라인 디바이스와 연결된 최상위 수준 아이콘이 선택됩니다.
허용되는 문자열은 TSPI_lineGetID 와 동일합니다. 예를 들어 줄이 Comm API를 지원하는 경우 comm/datamodem을 lpszDeviceClass 로 전달하면 공급자가 서비스 공급자의 Comm 디바이스 함수와 관련된 아이콘을 반환합니다.
lphIcon
아이콘에 대한 핸들이 반환되는 메모리 위치에 대한 포인터입니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
설명
공급자는 (lphIcon이 가리키는 DWORD에서) 핸들을 아이콘 리소스(에서 가져온)로 반환해야 합니다.
LoadIcon 함수) 지정된 줄과 연결됩니다.
공급자는 많은 아이콘(lpszDeviceClass 및/또는 줄 번호로 선택됨), 단일 아이콘(예: 선택한 lpszDeviceClass에 관계없이 모든 TSPI_lineGetIcon 요청에 대해 반환되는 제조업체의 경우) 또는 아이콘을 지원하지 않도록 선택할 수 있습니다. 이 경우 lphIcon에서 가리키는 DWORD를 NULL로 설정합니다. TAPI는 공급자가 반환한 핸들을 검사하고 공급자가 NULL을 반환하는 경우 TAPI는 일반 전화 통신 아이콘(일반 "줄" 아이콘)을 대체합니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |