Função WsGetNamespaceFromPrefix (webservices.h)

Essa função retorna um namespace do prefixo ao qual está associada.

Se o valor do parâmetro necessário for definido como TRUE e o Prefixo não estiver associado a nenhum namespace, uma exceção WS_E_INVALID_FORMAT será retornada. (Consulte Valores retornados dos Serviços Web do Windows.) Se o parâmetro necessário for FALSE e o Prefixo não estiver associado a nenhum namespace, o parâmetro ns será NULL e a função retornará S_FALSE.

Sintaxe

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

Parâmetros

[in] reader

Um ponteiro para o leitor para o qual o prefixo deve ser pesquisado.

[in] prefix

Um ponteiro para o Prefixo a ser pesquisado.

[in] required

O valor desse parâmetro booliano determina se um erro deve ou não ser retornado se um namespace correspondente não for encontrado.

ns

Uma referência a um namespace ao qual o prefixo será associado se tiver êxito. O valor retornado é válido somente até que o gravador avance.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Valor retornado

Essa função pode retornar um desses valores.

Comentários

Para o prefixo "xml", ele retornará o namespace "http://www.w3.org/XML/1998/namespace".

Para o prefixo "xmlns", ele retornará o namespace "http://www.w3.org/2000/xmlns/".

Requisitos