다음을 통해 공유

IWSDXMLContext::AddNamespace 메서드(wsdxml.h)

  • 아티클

XML 컨텍스트에서 네임스페이스를 나타내는 개체를 만듭니다. 네임스페이스가 이미 있는 경우 새 네임스페이스가 추가되지 않으며 기존 이름의 네임스페이스 개체가 반환됩니다.

구문

HRESULT AddNamespace(
  [in]  LPCWSTR          pszUri,
  [in]  LPCWSTR          pszSuggestedPrefix,
  [out] WSDXML_NAMESPACE **ppNamespace
);

매개 변수

[in] pszUri

네임스페이스의 URI입니다.

[in] pszSuggestedPrefix

XML을 생성할 때 사용할 네임스페이스 접두사입니다. 네임스페이스가 이미 있는 경우 pszSuggestedPrefix 는 현재 네임스페이스와 연결된 접두사를 덮어씁니다. XML 컨텍스트는 다른 네임스페이스 접두사를 할당할 수 있습니다. XML 컨텍스트에서 할당한 접두사는 제안된 접두사보다 우선합니다. ppNamespace가 가리키는 구조체의 PreferredPrefix 멤버에는 XML 컨텍스트에서 할당한 접두사를 포함합니다.

[out] ppNamespace

네임스페이스를 나타내는 WSDXML_NAMESPACE 구조체의 주소에 대한 포인터입니다. WSDFreeLinkedMemory를 호출하여 ppNamespace의 할당을 취소해야 합니다. 이 매개 변수는 선택적 요소입니다.

반환 값

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드 Description
S_OK
 메서드가 성공했습니다.
E_INVALIDARG
 pszUri 는 NULL이고, URI 문자열의 문자 길이가 WSD_MAX_TEXT_LENGTH(8192)를 초과하거나 , pszSuggestedPrefix 가 NULL이거나, 접두사 문자열의 문자 길이가 WSD_MAX_TEXT_LENGTH(8192)를 초과합니다.
E_OUTOFMEMORY
 메모리가 부족하여 작업을 완료할 수 없습니다.
E_FAIL
 메서드가 실패했습니다.

설명

반환된 WSDXML_NAMESPACE 구조체를 사용하여 네임스페이스 접두사( pszSuggestedPrefix로 지정됨)와 네임스페이스 URI( pszUri로 지정됨) 간의 연결을 강제 적용할 수 있습니다. 이 연결이 설정되면 XML 생성기는 지정된 네임스페이스 접두사를 사용하여 XML을 생성합니다.

AddNamespace를 호출하여 AddNameToNamespace 호출에 의해 네임스페이스가 자동으로 생성될 때 생성된 WSDXML_NAMESPACE 구조를 검색할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wsdxml.h(Wsdapi.h 포함)
DLL Wsdapi.dll

추가 정보

IWSDXMLContext