Método IWSDXMLContext::AddNameToNamespace (wsdxml.h)

Cria um objeto que representa um nome em um namespace em um contexto XML. Se o nome já existir no namespace, nenhum novo nome será adicionado e o objeto name para o nome existente será retornado.

Sintaxe

HRESULT AddNameToNamespace(
  [in]  LPCWSTR     pszUri,
  [in]  LPCWSTR     pszName,
  [out] WSDXML_NAME **ppName
);

Parâmetros

[in] pszUri

O URI do namespace XML no qual esse nome será criado. Se esse namespace ainda não existir no contexto XML, uma nova estrutura de namespace será gerada automaticamente.

[in] pszName

O nome a ser adicionado ao namespace especificado por pszUri.

[out] ppName

Uma estrutura WSDXML_NAME para o nome recém-criado. Você deve desalocar ppName chamando WSDFreeLinkedMemory. Esse parâmetro é opcional.

Retornar valor

Os valores retornados possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	pszUri é NULL ou o comprimento em caracteres da cadeia de caracteres de URI excede WSD_MAX_TEXT_LENGTH (8192). pszName é NULL ou o comprimento em caracteres da cadeia de caracteres de nome excede WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY	Memória insuficiente para concluir a operação.
E_FAIL	O método falhou.

Comentários

AddNameToNamespace pode ser usado ao criar elementos XML para seções extensíveis. Seções extensíveis são representadas pelo elemento any em um esquema. A estrutura de WSDXML_NAME retornada apontada por ppName pode ser usada para especificar o nome associado ao conteúdo da extensão. Ao criar uma estrutura WSDXML_ELEMENT que representa o conteúdo da extensão, use a estrutura de WSDXML_NAME retornada para o membro Name do elemento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wsdxml.h (include Wsdapi.h)
DLL	Wsdapi.dll

Confira também

IWSDXMLContext