다음을 통해 공유

IUPnPServiceAsync::BeginInvokeAction 메서드(upnp.h)

  • 아티클

BeginInvokeAction 메서드는 비동기 모드에서 디바이스에서 작업을 호출합니다. 또한 지연된 SCPD 다운로드 및 이벤트 구독이 옵트인되고 아직 수행되지 않은 경우 이 메서드는 SCPD 다운로드를 시작합니다.

구문

HRESULT BeginInvokeAction(
  [in]           BSTR             bstrActionName,
  [in]           VARIANT          vInActionArgs,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

매개 변수

[in] bstrActionName

호출할 메서드를 지정합니다.

[in] vInActionArgs

메서드에 대한 입력 인수의 배열을 지정합니다. 작업에 입력 인수가 없는 경우 이 매개 변수에는 빈 배열이 포함되어야 합니다. 이 배열의 내용은 서비스별로 다릅니다.

[in, optional] pAsyncResult

IUPnPAsyncResult 개체에 대한 포인터입니다. BeginInvokeAction 호출이 완료되면 UPnP는 IUPnPAsyncResult::AsyncOperationComplete 메서드를 사용하여 제어점에 알립니다.

[out] pullRequestID

비동기 I/O 작업을 식별하는 데 사용되는 64비트 ULONG 값에 대한 포인터입니다. 제어점은 EndInvokeAction을 사용하여 이 작업을 종료하거나 취소하는 동안 이 핸들을 쿠키로 사용해야 합니다.

반환 값

성공하면 S_OK를 반환합니다. 그렇지 않으면 메서드는 WinError.h 에 정의된 COM 오류 코드 또는 다음 값 중 하나를 반환합니다.

반환 코드 설명
E_PENDING
 이 IUPnPServiceAsync 개체에서 또 다른 비동기 작업이 수행되고 있습니다. 다른 IUPnPServiceAsync instance 만들거나 IUPnPServiceAsync::CancelAsyncOperation을 사용하여 실행 중인 작업을 취소합니다.
E_FAIL
 작업을 시작하지 못했습니다.
UPNP_E_INVALID_ACTION
 이 작업은 디바이스에서 지원되지 않습니다.
 
참고 일부 값은 UPnP 인증 디바이스에서 오류가 수신되었음을 나타낼 수 있습니다. 자세한 내용은 디바이스 오류 코드를 참조하세요.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 upnp.h
DLL Upnp.dll

추가 정보

IUPnPServiceAsync

IUPnPServiceAsync::EndInvokeAction