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

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

Sintaxe

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

Parâmetros

[in] pszUri

O URI do namespace.

[in] pszSuggestedPrefix

O prefixo de namespace a ser usado ao gerar XML. Se o namespace já existir, pszSuggestedPrefix substituirá o prefixo atualmente associado ao namespace. O contexto XML pode atribuir um prefixo de namespace diferente. O prefixo atribuído pelo contexto XML tem precedência sobre o prefixo sugerido. O membro PreferredPrefix da estrutura apontada por ppNamespace contém o prefixo atribuído pelo contexto XML.

[out] ppNamespace

Ponteiro para o endereço da estrutura WSDXML_NAMESPACE que representa o namespace. Você deve desalocar ppNamespace chamando WSDFreeLinkedMemory. Esse parâmetro é opcional.

Retornar valor

Os possíveis valores retornados 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, o comprimento em caracteres da cadeia de caracteres de URI excede WSD_MAX_TEXT_LENGTH (8192), pszSuggestedPrefix é NULL ou o comprimento em caracteres da cadeia de caracteres de prefixo excede WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY
Memória insuficiente para concluir a operação.
E_FAIL
O método falhou.

Comentários

A estrutura de WSDXML_NAMESPACE retornada pode ser usada para forçar uma associação entre o prefixo de namespace (conforme especificado por pszSuggestedPrefix) e o URI do namespace (conforme especificado por pszUri). Depois que essa associação for estabelecida, o gerador XML produzirá XML com o prefixo de namespace especificado.

Você pode chamar AddNamespace para recuperar a estrutura WSDXML_NAMESPACE criada quando um namespace foi gerado automaticamente por uma chamada para AddNameToNamespace.

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 (inclua Wsdapi.h)
DLL Wsdapi.dll

Confira também

IWSDXMLContext