다음을 통해 공유

WsWriteQualifiedName 함수(webservices.h)

  • 아티클

XML 정규화된 이름을 기록기에 씁니다.

구문

HRESULT WsWriteQualifiedName(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in, optional] const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

매개 변수

[in] writer

정규화된 이름이 기록되는 WS_XML_WRITER 개체에 대한 포인터입니다. 포인터는 유효한 XML Writer 개체를 참조해야 합니다.

[in, optional] prefix

정규화된 이름에서 사용하는 접두사에 대한 WS_XML_STRING 포인터입니다. 이 매개 변수에서 참조하는 값이 NULL 이면 기록기에서 접두사를 선택합니다.

[in] localName

정규화된 이름에서 사용하는 로컬 이름에 대한 WS_XML_STRING 포인터입니다. 길이가 하나 이상이어야 합니다.

[in, optional] ns

정규화된 이름에 사용되는 네임스페이스에 대한 WS_XML_STRING 포인터입니다.

접두사를 지정하지 않으면 기록기는 지정된 네임스페이스에 바인딩된 scope 접두사를 사용하거나 접두사를 생성하고 XMLNS 특성을 포함할 수 있습니다.

접두사를 지정하면 기록기에서 해당 접두사를 사용하고 scope 기존 접두사를 재정의해야 하는 경우 XMLNS 특성을 포함할 수 있습니다.

[in, optional] error

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

반환 값

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

반환 코드 설명
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
WS_E_INVALID_FORMAT
 입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.

설명

  • 접두사 NULL이면 네임스페이스가 NULL이 아니어야 합니다. 이 경우 작성기는 지정된 네임스페이스에 바인딩된 scope 접두사를 찾으려고 합니다. 적절한 접두사를 발견하면 사용됩니다. 그렇지 않은 경우 기록기는 접두사를 생성하고 현재 요소에 XMLNS 특성을 삽입합니다. 작성기가 요소에 없는 경우 함수는 WS_E_INVALID_FORMAT 반환합니다.

    ( Windows Web Services 반환 값을 참조하세요.)

  • 접두사 NULL 이 아니고 네임스페이스가 NULL 이 아닌 경우 기록기는 접두사가 현재 지정된 네임스페이스에 바인딩되어 있는지 확인하고 그렇지 않으면 WS_E_INVALID_FORMAT 반환합니다.
  • 접두사 NULL 이 아니고 네임스페이스가 NULL 인 경우 기록기는 접두사 및 로컬 이름을 사용하여 정규화된 이름을 작성합니다.

요구 사항

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