WsInitializeMessage 함수(webservices.h)

이 함수는 처리를 준비하기 위해 메시지의 헤더를 초기화합니다. 메시지가 초기화되면 애플리케이션에서 헤더를 추가할 수 있습니다. 성공 시 메시지는 WS_MESSAGE_STATE_INITIALIZED 상태입니다. 함수가 실패하면 상태 전환이 발생하지 않습니다.

구문

HRESULT WsInitializeMessage(
  [in]           WS_MESSAGE                *message,
  [in]           WS_MESSAGE_INITIALIZATION initialization,
  [in, optional] WS_MESSAGE                *sourceMessage,
  [in, optional] WS_ERROR                  *error
);

매개 변수

[in] message

초기화할 Message 개체에 대한 포인터입니다. Message는 유효한 WS_MESSAGE 개체여야 instance WsCreateMessage 또는 WsCreateMessageForChannel에서 반환되며 NULL이 아닐 수 있습니다.

[in] initialization

메시지 초기화를 정의합니다.

참고초기화 값이 WS_REPLY_MESSAGE 또는 WS_FAULT_MESSAGE 설정되면 메시지가 자동으로 처리됩니다.

 

[in, optional] sourceMessage

메시지 매개 변수를 초기화하는 데 사용되는 메시지 개체에 대한 포인터입니다. 초기화 매개 변수에 WS_DUPLICATE_MESSAGE, WS_REPLY_MESSAGE또는WS_FAULT_MESSAGE 값이 없는 한 이 값은 NULL이어야 합니다.

[in, optional] error

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

반환 값

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

반환 코드	설명
E_OUTOFMEMORY	메모리가 부족합니다.
E_INVALIDARG	하나 이상의 인수가 잘못되었습니다.
기타 오류	이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

메시지의 초기 발신자는 WsSetHeader를 사용하여 메시지에 작업 헤더를 추가해야 합니다.

이 API는 WsWriteEnvelopeStart 또는 WsWriteMessageStart 가 메시지에 대해 호출되기 전에 호출되어야 합니다.

요구 사항

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