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

BeginQueryStateVariable 메서드는 특정 서비스의 상태 변수 값에 대한 비동기 요청을 시작합니다. 또한 지연된 SCPD(서비스 제어 프로토콜 설명) 다운로드 및 이벤트 구독에 대한 옵트인(opt-in)이 표시되고 아직 수행되지 않은 경우 이 메서드는 SCPD 다운로드 및 이벤트 구독을 시작합니다.

구문

HRESULT BeginQueryStateVariable(
  [in]           BSTR             bstrVariableName,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

매개 변수

[in] bstrVariableName

요청된 상태 변수 값을 지정합니다.

[in, optional] pAsyncResult

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

[out] pullRequestID

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

반환 값

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

반환 코드	설명
E_FAIL	비동기 작업을 시작하지 못했습니다.
UPNP_E_INVALID_VARIABLE	bstrVariableName으로 표시된 요청된 상태 변수가 없습니다.

 

참고 일부 값은 UPnP 인증 디바이스에서 오류가 수신되었음을 나타낼 수 있습니다. 자세한 내용은 디바이스 오류 코드를 참조하세요.

 

설명

이 메서드를 사용하여 이벤트 상태 변수를 쿼리하기 전에 이벤트 구독을 완료해야 합니다. 이 문제가 발생하지 않으면 UPNP_E_VARIABLE_VALUE_UNKNOWN 반환되고 이벤트 구독이 내부적으로 수행됩니다. 결과적으로 다음 BeginQueryStateVariable 호출이 성공합니다.

참고 이벤트 변수가 없는 서비스의 경우 이 메서드는 항상 예상대로 작동합니다.

 

요구 사항

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

추가 정보

IUPnPServiceAsync

IUPnPServiceAsync::CancelAsyncOperation