phoneSetData 함수(tapi.h)

phoneSetData 함수는 지정된 버퍼의 정보를 선택한 데이터 식별자의 열린 휴대폰 디바이스에 다운로드합니다.

구문

LONG phoneSetData(
  HPHONE       hPhone,
  DWORD        dwDataID,
  LPVOID const lpData,
  DWORD        dwSize
);

매개 변수

hPhone

열려 있는 휴대폰 디바이스에 대한 핸들입니다. 애플리케이션은 휴대폰의 소유자여야 합니다.

dwDataID

휴대폰 디바이스에서 버퍼를 다운로드할 위치입니다.

lpData

데이터를 다운로드할 메모리 위치에 대한 포인터입니다.

dwSize

버퍼의 크기(바이트)입니다.

반환 값

함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하거나 오류가 발생할 경우 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 PHONE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED.

설명

phoneSetData 함수는 lpData에서 휴대폰 디바이스로 최대 dwSize 바이트를 다운로드합니다. 데이터 형식, 휴대폰 디바이스에 대한 의미 및 데이터 식별자의 의미는 서비스 공급자에 따라 다릅니다. 버퍼의 데이터 또는 데이터 식별자 선택 항목이 휴대폰 디바이스에 대한 명령으로 작동할 수 있습니다.

요구 사항

추가 정보

PHONE_REPLY

보조 전화 서비스 함수

TAPI 2.2 참조 개요