IMbnDeviceService::SetCommand 메서드(mbnapi.h)

중요

Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.

SET 컨트롤 명령을 모바일 광대역 디바이스의 디바이스 서비스로 보냅니다.

구문

HRESULT SetCommand(
  [in]  ULONG     commandID,
  [in]  SAFEARRAY *deviceServiceData,
  [out] ULONG     *requestID
);

[in] commandID

명령에 대한 식별자입니다.

[in] deviceServiceData

디바이스에 전달되는 바이트 배열입니다.

[out] requestID

이 요청을 식별하기 위해 모바일 광대역 서비스에서 할당한 고유한 요청 ID입니다.

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

반환 코드	Description
S_OK	메서드가 완료되었습니다.
E_ACCESSDENIED	이 디바이스 서비스 명령은 프로세스 권한을 호출할 수 없습니다.
기타	이 메서드를 실행할 때 오류가 발생했습니다.

SetCommand 는 모바일 광대역 API에서 다루지 않는 공급업체별 디바이스 서비스 기능을 구현하기 위해 존재합니다. 애플리케이션이 SetCommand를 호출하려면 먼저 디바이스 서비스의 명령 세션을 열어야 합니다.

모바일 광대역 서비스는 디바이스에 SET 요청을 실행합니다. deviceServiceData 는 요청에 전달된 데이터 버퍼에 바이트 바이트를 복사합니다. 이 데이터 버퍼는 MaxCommandSize 바이트보다 작아야 합니다.

이는 비동기 작업이며 SetCommand 는 즉시 반환됩니다. 작업이 완료되면 모바일 광대역 서비스는 IMbnDeviceServicesEvents 인터페이스의 OnSetCommandComplete 메서드를 호출합니다.