TSPI_lineGetAddressID 함수(tspi.h)
TSPI_lineGetAddressID 함수는 지정된 줄에서 주소와 연결된 주소 식별자를 다른 형식으로 반환합니다.
구문
LONG TSPIAPI TSPI_lineGetAddressID(
HDRVLINE hdLine,
LPDWORD lpdwAddressID,
DWORD dwAddressMode,
LPCWSTR lpsAddress,
DWORD dwSize
);
매개 변수
hdLine
주소를 검색할 줄에 대한 서비스 공급자의 핸들입니다.
lpdwAddressID
주소 식별자가 반환되는 DWORD 크기의 메모리 위치에 대한 포인터입니다.
dwAddressMode
lpsAddress에 포함된 주소의 주소 모드입니다. dwAddressMode 매개 변수는 LINEADDRESSMODE_ 상수 중 하나만 가질 수 있습니다.
lpsAddress
지정된 줄 디바이스에 할당된 주소를 포함하는 데이터 구조체에 대한 포인터입니다. 주소의 형식은 dwAddressMode 매개 변수에 의해 결정됩니다. LINEADDRESSMODE_DIALABLEADDR 경우 lpsAddress 매개 변수는 일반적인 전화 걸기 가능 번호 형식을 사용하며 NULL 이 종료됩니다.
dwSize
lpsAddress에 포함된 주소의 크기입니다. 매개 변수 dwSize 는 LINEADDRESSMODE_DIALABLEADDR 사용되는 경우 문자열의 길이( NULL에 대해 하나 더하기)로 설정해야 합니다. 확장 LINEADDRESSMODE를 사용하는 경우 길이는 실제로 전달된 항목의 크기와 일치해야 합니다(DLL은 지정된 포인터에서 지정된 바이트 수를 읽을 수 있는지 확인합니다).
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
설명
이 함수는 회선 디바이스에 할당된 전화 번호(주소)를 줄의 디바이스 기능에 반환되는 dwAddressID (0부터 1을 뺀 주소 수까지의 범위)에 다시 매핑하는 데 사용됩니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |