lineGetAddressID 함수(tapi.h)

아티클
03/08/2023

lineGetAddressID 함수는 지정된 줄에서 주소와 연결된 주소 식별자를 다른 형식으로 반환합니다.

구문

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

매개 변수

hLine

열린 줄 디바이스에 대한 핸들입니다.

lpdwAddressID

주소 식별자가 반환되는 DWORD 크기의 메모리 위치에 대한 포인터입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

dwAddressMode

lpsAddress에 포함된 주소의 주소 모드입니다. 이 매개 변수는 LINEADDRESSMODE_ 상수 중 하나만 사용합니다. LINEADDRESSMODE_DIALABLEADDR 지정해야 합니다.

lpsAddress

지정된 줄 디바이스에 할당된 주소를 보유하는 데이터 구조체에 대한 포인터입니다. 주소의 형식은 dwAddressMode에 의해 결정됩니다. 유효한 값만 LINEADDRESSMODE_DIALABLEADDR lpsAddress 는 일반적인 전화 걸기 가능 번호 형식을 사용하며 null로 종료됩니다.

dwSize

lpsAddress에 포함된 주소의 크기(바이트)입니다. 문자열의 크기에는 null 종결자가 포함되어야 합니다.

반환 값

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

설명

lineGetAddressID 함수는 줄 디바이스에 할당된 전화 번호(주소)를 0 범위의 dwAddressID에 다시 매핑하는 데 사용됩니다. lineMakeCall 함수를 사용하면 줄 핸들과 줄에 주소를 지정하여 애플리케이션에서 호출을 할 수 있습니다. 주소는 dwAddressID, 전화 번호 또는 디바이스별 이름 또는 식별자로 지정할 수 있습니다. 한 줄에 여러 주소가 할당된 환경에서는 전화 번호를 사용하는 것이 실용적일 수 있습니다.

참고 LINEADDRESSMODE_ADDRESSID lineGetAddressID와 함께 사용할 수 없습니다.