ITLegacyAddressMediaControl::GetID 메서드(tapi3if.h)

  • 아티클

GetID 메서드는 현재 주소와 연결된 지정된 디바이스 클래스에 대한 디바이스 식별자를 반환합니다.

이 메서드는 C/C++ 애플리케이션에만 사용됩니다. Visual Basic 및 스크립팅 애플리케이션에 사용할 수 있는 해당 메서드는 없습니다.

구문

HRESULT GetID(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceID
);

매개 변수

[in] pDeviceClass

구성 정보가 필요한 TAPI 디바이스 클래스를 포함하는 BSTR에 대한 포인터입니다.

[out] pdwSize

반환된 디바이스 식별자의 길이입니다.

[out] ppDeviceID

디바이스 식별자입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 메서드가 정상적으로 실행되었습니다.
E_FAIL
 메서드가 실패했습니다. 이는 현재 주소와 연결된 지정된 클래스의 디바이스가 없음을 의미할 수 있습니다.
E_POINTER
 pdwSize 또는 ppDeviceID 매개 변수가 유효한 포인터가 아닙니다.

설명

애플리케이션은 이 메서드를 호출하기 전에 ITTAPI::RegisterCallNotifications 를 호출해야 합니다.

애플리케이션은 SysAllocString을 사용하여 pDeviceClass 매개 변수에 대한 메모리를 할당하고 SysFreeString을 사용하여 변수가 더 이상 필요하지 않을 때 메모리를 해제해야 합니다.

애플리케이션은 CoTaskMemFree 함수를 호출하여 ppDeviceID 매개 변수에 할당된 메모리를 해제해야 합니다.

TAPI 2.1 상호 참조: lineGetDevConfig, lineSetDevConfig, lineGetID

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi3if.h(Tapi3.h 포함)
라이브러리 Uuid.lib
DLL Tapi3.dll

추가 정보

GetDevConfig

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig