IWbemCallResult::GetResultString 메서드(wbemcli.h)
IWbemCallResult::GetResultString 메서드는 IWbemServices::P UtInstance에서 새로 만든 instance 할당된 개체 경로를 반환합니다.
참고 호출 결과 개체는 공급자가 PutInstance 호출을 수행하고 클라이언트가 공급자에 할당된 개체 경로(키 속성의 값)를 알아야 할 때 주로 사용됩니다. 예를 들어 클래스 키 속성이 PutInstance 작업 중에 공급자가 할당한 GUID(Globally Unique Identifier)인 경우 공급자가 이러한 방식으로 반환할 수 없다면 클라이언트는 이 GUID를 알 수 없습니다.
구문
HRESULT GetResultString(
[in] long lTimeout,
[out] BSTR *pstrResultString
);
매개 변수
[in] lTimeout
반환하기 전에 이 호출이 차단하는 최대 시간(밀리초)을 지정합니다. 상수 WBEM_INFINITE (0xFFFFFFFF)을 사용하는 경우 개체 경로를 사용할 수 있게 될 때까지 호출이 차단됩니다. 0을 사용하는 경우 호출은 개체 경로 또는 상태 코드를 즉시 반환합니다.
[out] pstrResultString
NULL일 수 없습니다. 이 매개 변수는 개체 경로에 대한 포인터를 수신하며, 그러면 새로 만든 개체로 연결됩니다. 반환된 문자열은 시스템 호출 SysFreeString을 사용하여 할당을 취소해야 합니다. 오류가 발생하면 새 문자열이 반환되지 않습니다.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT에 포함된 값이 나열되어 있습니다.
오류가 발생하면 COM 함수 GetErrorInfo 를 호출하여 더 많은 오류 정보를 얻을 수 있습니다.
네트워크 문제로 인해 Windows Management에 대한 원격 연결이 끊어지는 경우에도 COM 관련 오류 코드가 반환될 수 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista |
지원되는 최소 서버 | Windows Server 2008 |
대상 플랫폼 | Windows |
헤더 | wbemcli.h(Wbemidl.h 포함) |