Funzione WsGetPrefixFromNamespace (webservices.h)

Articolo
03/13/2024

Questa funzione restituisce il prefisso a cui è associato uno spazio dei nomi. Nell'ambito potrebbero essere presenti più prefissi e questa funzione può restituire uno qualsiasi di essi.

Nota In nessuna condizione un chiamante deve dipendere o aspettarsi che venga restituito un prefisso specifico quando è presente più di un prefisso che può essere restituito.

Se il valore del parametro obbligatorio è impostato su TRUE e lo spazio dei nomi non è associato ad alcun prefisso, verrà restituita un'eccezione WS_E_INVALID_FORMAT . Vedere Valori restituiti di Servizi Web Windows. Se il parametro obbligatorio è FALSE e namespace non è associato ad alcun prefisso, il parametro del prefisso è NULL e la funzione restituisce S_FALSE.

Se WsWriteStartElement viene chiamato ma l'elemento non viene eseguito il commit degli spazi dei nomi e dei prefissi a cui fa riferimento l'elemento e gli attributi nell'elemento non sono disponibili per questa funzione.

Sintassi

HRESULT WsGetPrefixFromNamespace(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
                 const WS_XML_STRING **prefix,
  [in, optional] WS_ERROR            *error
);

Parametri

[in] writer

Puntatore a un writer con lo spazio dei nomi da cercare. Deve essere un oggetto WS_XML_WRITER valido restituito da WsCreateWriter e potrebbe non essere NULL.

[in] ns

Spazio dei nomi da cercare.

[in] required

Indica se deve essere restituito un errore se non viene trovato un prefisso corrispondente.

prefix

Riferimento a un prefisso associato allo spazio dei nomi o NULL se il valore del parametro obbligatorio è FALSE e non viene trovato uno spazio dei nomi corrispondente.

Nota Il valore restituito è valido solo fino a quando il writer non avanza.

[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 lo spazio dei nomi "http://www.w3.org/XML/1998/namespace" restituirà il prefisso "xml".

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

Il prefisso restituito non deve essere modificato ed è valido solo fino all'avanzamento del writer.

Requisiti

Requisito	Valore
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