다음을 통해 공유

WsWriteXmlnsAttribute 함수(webservices.h)

  • 아티클

Xmlns 특성을 현재 요소에 씁니다. 특성을 작성하기 전에 WsWriteStartElement를 호출해야 하며 특성 수가 기록기에 허용되는 최대 특성 수를 초과하는 경우 함수는 WS_E_QUOTA_EXCEEDED 반환합니다. ( Windows Web Services 반환 값을 참조하세요.)

구문

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

매개 변수

[in] writer

Xmlns 특성이 기록되는 WS_XML_WRITER 개체에 대한 포인터입니다. 포인터는 유효한 XML 기록 기 개체를 참조해야 합니다.

[in, optional] prefix

시작 요소에 사용할 접두사에 대한 WS_XML_STRING 포인터입니다. 이 매개 변수에서 참조하는 값이 NULL 이면 기록기는 특성을 선택합니다.

xmlns 특성에 사용할 접두사를 지정합니다.

[in] ns

접두사에 바인딩할 네임스페이스에 대한 WS_XML_STRING 포인터입니다.

[in] singleQuote

특성 값에 단일 또는 큰따옴표를 사용할지 여부를 결정합니다.

참고WS_XML_WRITER_BINARY_ENCODING 설정된 경우 따옴표 문자는 유지되지 않으며 이 매개 변수는 영향을 주지 않습니다.

 

[in, optional] error

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

반환 값

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

반환 코드 설명
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
WS_E_INVALID_OPERATION
 개체의 현재 상태로 인해 작업이 허용되지 않습니다.
WS_E_INVALID_FORMAT
 입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.
WS_E_QUOTA_EXCEEDED
 할당량을 초과했습니다.

설명

다음 조건이 적용됩니다.

  • 빈 접두사를 지정하면 기본 네임스페이스가 할당됩니다.
  • NULL 접두사를 지정하면 기록기에서 네임스페이스에 적합한 접두사를 선택합니다.
  • Xmlns 특성이 중복되면 쓸 수 없습니다.
  • 비어 있지 않은 접두사를 빈 네임스페이스로 지정하면 WS_E_INVALID_FORMAT 반환됩니다.

요구 사항

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