phoneGetIcon 함수(tapi.h)

아티클
08/26/2023

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

구문

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

매개 변수

dwDeviceID

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

lpszDeviceClass

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

lphIcon

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

반환 값

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

PHONEERR_BADDEVICEID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_NOMEM, PHONEERR_NODEVICE.

설명

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

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

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