WsGetMessageProperty 함수(webservices.h)

지정된 Message 개체 속성을 검색합니다. 검색할 속성은 WS_MESSAGE_PROPERTY_ID 입력 매개 변수로 식별됩니다.

구문

HRESULT WsGetMessageProperty(
  [in]           WS_MESSAGE             *message,
  [in]           WS_MESSAGE_PROPERTY_ID id,
                 void                   *value,
  [in]           ULONG                  valueSize,
  [in, optional] WS_ERROR               *error
);

매개 변수

[in] message

desired 속성을 포함하는 Message 개체에 대한 포인터입니다. 이 매개 변수는 유효한 WS_LISTENER 개체여야 합니다.

[in] id

desired 속성을 식별하는 WS_MESSAGE_PROPERTY_ID 열거자 값입니다.

value

검색된 속성 값을 저장하기 위한 위치에 대한 참조입니다. 포인터는 속성 형식과 호환되는 맞춤이 있어야 합니다.

[in] valueSize

검색된 속성 값을 저장하기 위해 호출자가 할당한 바이트 길이 버퍼 크기입니다.

[in, optional] error

함수가 실패할 경우 오류에 대한 추가 정보를 저장해야 하는 WS_ERROR 개체에 대한 포인터입니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
E_INVALIDARG	이 개체에 대해 속성 ID가 지원되지 않았거나 지정된 버퍼가 값에 충분히 크지 않았습니다.
E_OUTOFMEMORY	애플리케이션에 메모리가 부족합니다.
기타 오류	이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	webservices.h
라이브러리	WebServices.lib
DLL	WebServices.dll