lineAgentSpecific 함수(tapi.h)

아티클
03/05/2024

lineAgentSpecific 함수를 사용하면 애플리케이션이 주소와 연결된 에이전트 처리기의 독점 처리기 관련 함수에 액세스할 수 있습니다. 확장의 의미는 에이전트 처리기에 따라 다릅니다. 각 에이전트 관련 확장 집합은 해당 확장의 공표자(일반적으로 전화 통신 서버의 에이전트 처리기 소프트웨어 작성자)에서 확장 사양과 함께 가져와야 하는 보편적으로 고유한 128비트 확장 ID로 식별됩니다. 에이전트 처리기에서 지원하는 확장 목록은 lineGetAgentCaps에서 반환된 LINEAGENTCAPS 구조체에서 가져옵니다.

구문

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

매개 변수

hLine

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

dwAddressID

열린 줄 디바이스의 주소입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

dwAgentExtensionIDIndex

호출되는 에이전트 처리기 확장의 LINEAGENTCAPS에서 ExtensionIDList 구조체의 위치입니다.

lpParams

매개 변수 블록을 보유하는 데 사용되는 메모리 영역에 대한 포인터입니다. 이 매개 변수 블록의 형식은 디바이스별이며 해당 콘텐츠는 TAPI에서 전화 통신 서버의 에이전트 처리기 애플리케이션과 전달됩니다. 이 매개 변수 블록은 호출할 함수를 지정하고 반환할 데이터를 위한 충분한 공간을 포함해야 합니다.

dwSize

매개 변수 블록 영역의 크기(바이트)입니다.

참고lpParams 가 문자열에 대한 포인터인 경우 크기에 NULL 종결자가 포함되어야 합니다.

반환 값

비동기 작업이 시작되면 양수 요청 식별자를 반환합니다. 그렇지 않으면 이 함수는 다음 음수 오류 값 중 하나를 반환합니다.

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

추가 반환 값은 에이전트 처리기에만 적용됩니다.

설명

이 작업은 확장 전화 통신 서비스의 일부입니다. 해당 의미를 정의하지 않고 에이전트 처리기별 기능에 액세스할 수 있습니다.

이 함수는 제네릭 매개 변수 프로필을 제공합니다. 매개 변수 구조의 해석은 처리기별입니다. 처리기별 애플리케이션으로 다시 전송되는 표시 및 회신은 LINE_AGENTSPECIFIC 메시지를 사용해야 합니다.

에이전트 처리기는 이 함수에 사용할 매개 변수를 정의하여 처리기별 함수에 대한 액세스를 제공할 수 있습니다. 이러한 확장을 사용하려는 애플리케이션은 정의된 확장을 설명하는 공급업체별 설명서를 참조해야 합니다. 일반적으로 이러한 확장을 사용하는 애플리케이션은 다른 에이전트 처리기 환경에서 작업할 수 없습니다.