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 |
---|---|
|
메서드가 정상적으로 실행되었습니다. |
|
메서드가 실패했습니다. 이는 현재 주소와 연결된 지정된 클래스의 디바이스가 없음을 의미할 수 있습니다. |
|
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 |