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

GetID 메서드는 현재 호출과 연결된 디바이스의 식별자를 가져옵니다.

이 메서드는 C/C++ 애플리케이션을 위한 것입니다. Visual Basic 및 스크립팅 애플리케이션은 ITLegacyCallMediaControl2::GetIDAsVariant 메서드를 사용해야 합니다.

구문

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

[in] pDeviceClass

TAPI 디바이스 클래스를 나타내는 BSTR에 대한 포인터입니다.

[out] pdwSize

디바이스 식별자의 크기(바이트)입니다.

[out] ppDeviceID

디바이스 식별자입니다.

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

반환 코드	Description
S_OK	메서드가 정상적으로 실행되었습니다.
E_OUTOFMEMORY	작업을 수행하기 위한 메모리가 부족합니다.
E_POINTER	pdwSize 또는 ppDeviceID 매개 변수가 유효한 포인터가 아닙니다.

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

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

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