lineGetIcon 함수(tapi.h)

아티클
08/26/2023

lineGetIcon 함수를 사용하면 애플리케이션이 사용자에게 표시할 서비스 라인 디바이스별(또는 공급자별) 아이콘을 검색할 수 있습니다.

구문

LONG lineGetIcon(
  DWORD   dwDeviceID,
  LPCSTR  lpszDeviceClass,
  LPHICON lphIcon
);

매개 변수

dwDeviceID

아이콘이 요청된 줄 디바이스의 식별자입니다.

lpszDeviceClass

디바이스 클래스 이름을 식별하는 null로 끝나는 문자열에 대한 포인터입니다. 이 디바이스 클래스를 사용하면 애플리케이션에서 해당 디바이스 클래스에 적용되는 특정 하위 아이콘을 선택할 수 있습니다. 이 매개 변수는 선택 사항이며 NULL 또는 비워 둘 수 있습니다. 이 경우 지정된 미디어 스트림 디바이스가 아닌 선 디바이스와 연결된 최상위 수준 아이콘이 선택됩니다.

lphIcon

아이콘에 대한 핸들이 반환되는 메모리 위치에 대한 포인터입니다.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_BADDEVICEID, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_NODEVICE.

설명

lineGetIcon 함수를 사용하면 공급자가 지정된 줄과 연결된 아이콘 리소스(LoadIcon에서 가져온)에 핸들(lphIcon)을 반환합니다. 아이콘 핸들은 공급자와 연결된 리소스에 대한 것입니다. 애플리케이션은 공급자가 언로드된 후 아이콘을 참조하려는 경우 CopyIcon 을 사용해야 합니다. 이는 애플리케이션에 줄이 열려 있는 한 발생할 가능성이 낮습니다.

lpszDeviceClass 매개 변수를 사용하면 공급자가 호출자가 참조하는 서비스 유형에 따라 다른 아이콘을 반환할 수 있습니다. 허용되는 문자열은 lineGetID와 동일합니다. 예를 들어 줄이 Comm API를 지원하는 경우 "COMM"을 lpszDeviceClass 로 전달하면 공급자가 서비스 공급자의 Comm 디바이스 함수와 관련된 아이콘을 반환합니다. "tapi/line", "" 또는 NULL 매개 변수를 사용하여 줄 서비스에 대한 아이콘을 요청할 수 있습니다.

2.0 이전의 API 버전을 사용하는 애플리케이션의 경우 공급자가 아이콘을 반환하지 않는 경우(지정된 디바이스 클래스가 유효하지 않거나 공급자가 아이콘을 지원하지 않기 때문에) TAPI는 일반 전화 통신 줄 디바이스 아이콘을 대체합니다. API 버전 2.0 이상을 사용하는 애플리케이션의 경우 TAPI는 lpszDeviceClass 매개 변수가 "tapi/line", "" 또는 NULL인 경우에만 기본 줄 아이콘을 대체합니다. 다른 디바이스 클래스의 경우 지정된 디바이스 클래스가 유효하지 않거나 공급자가 클래스에 대한 아이콘을 지원하지 않는 경우 lineGetIcon 은 LINEERR_INVALDEVICECLASS 반환합니다.