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

EndQueryStateVariable 메서드는 이전 BeginQueryStateVariable 작업의 결과를 검색하고 결과 서비스별 상태 변수 값을 검색합니다.

구문

HRESULT EndQueryStateVariable(
  [in]          ULONG64 ullRequestID,
  [out, retval] VARIANT *pValue
);

[in] ullRequestID

이 호출 전에 시작된 BeginQueryStateVariable 작업에 해당하는 64비트 ULONG 값에 대한 포인터입니다.

[out, retval] pValue

입력에 빈 배열이 포함됩니다. 출력에서 는 bstrVariableName으로 BeginQueryStateVariable에 지정된 변수의 값에 대한 참조를 받습니다. 반환되는 데이터 형식은 쿼리가 호출된 상태 변수에 따라 달라집니다.

참고VariantClear를 사용하여 이 매개 변수의 지우기

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

반환 코드	설명
UPNP_E_DEVICE_ERROR	상태 변수가 이벤트되지 않고 원격 쿼리에서 오류 코드를 반환했습니다. 전송 오류가 아닙니다. 디바이스가 요청을 받았지만 오류가 반환되었습니다.
UPNP_E_INVALID_VARIABLE	요청된 상태 변수가 없습니다.
UPNP_E_DEVICE_TIMEOUT	디바이스가 30초 제한 시간 내에 응답하지 않았습니다.
UPNP_E_INVALID_ARGUMENTS	vInActionArgs로 전달된 인수 중 하나 이상이 잘못되었습니다.
UPNP_E_PROTOCOL_ERROR	UPnP 프로토콜 수준의 문제로 인해 쿼리가 완료되지 않았습니다.
UPNP_E_TRANSPORT_ERROR	상태 변수가 이벤트되지 않고 HTTP 문제로 인해 값에 대한 원격 쿼리가 실패했습니다. HTTP 오류 코드를 검색하려면 IUPnPService::LastTransportStatus를 사용합니다.
UPNP_E_VARIABLE_VALUE_UNKNOWN	상태 변수는 이벤트가 발생하지만 UPnP 소프트웨어는 여전히 이벤트 알림을 기다리고 있으므로 값을 반환할 수 없습니다.

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