Funzione WsGetNamespaceFromPrefix (webservices.h)

Articolo
08/27/2023

Questa funzione restituisce uno spazio dei nomi dal prefisso a cui è associato.

Se il valore del parametro obbligatorio è impostato su TRUE e il prefisso non è associato a uno spazio dei nomi WS_E_INVALID_FORMAT eccezione verrà restituito. Vedere Valori restituiti da Servizi Web Windows. Se il parametro richiesto è FALSE e il prefisso non è associato ad alcun spazio dei nomi, il parametro ns sarà NULL e la funzione restituirà S_FALSE.

Sintassi

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
);

Parametri

[in] reader

Puntatore al lettore per il quale è necessario cercare il prefisso.

[in] prefix

Puntatore al prefisso da cercare.

[in] required

Il valore di questo parametro booleano determina se deve essere restituito un errore se non viene trovato uno spazio dei nomi corrispondente.

ns

Riferimento a uno spazio dei nomi a cui è associato il prefisso se riuscito. Il valore restituito è valido solo fino all'avanzamento del writer.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.

Commenti

Per il prefisso "xml" restituirà lo spazio dei nomi "http://www.w3.org/XML/1998/namespace".

Per il prefisso "xmlns" restituirà lo spazio dei nomi "http://www.w3.org/2000/xmlns/".

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite